AspenEngineeringSuiteV7 1 Inst

Aspen Engineering V7.1

Installation Guide

Version Number: V7.1 January 2009

Copyright © 1981 – 2009 Aspen Technology, Inc. All rights reserved.

Aspen Acol+™, Aspen Adsim®, Aspen Adsorption , Aspen Air Cooled Exchanger, Aspen Basic Engineering, Aspen Batch , Process Developer, Aspen Batch Distillation, Aspen Batch Plus®, Aspen BatchSep™, Aspen Capital Cost Estimator, Aspen CatRef®, Aspen Chromatography®, Aspen COMThermo®, Aspen Custom Modeler®, Aspen Distillation Synthesis, Aspen Dynamics®, Aspen Energy Analyzer, Aspen FCC®, Aspen Fired Heater, Aspen FiredHeater, Aspen Flare System Analyzer, Aspen FLARENET™, Aspen HTFS , Research Network™, Aspen HTFS Research Network™, Aspen HX-Net®, Aspen Hydrocracker®, Aspen Hydrotreater™, Aspen HYSYS Amines™, Aspen HYSYS Amines™, Aspen HYSYS Dynamics™, Aspen HYSYS OLGAS 3-Phase™, Aspen HYSYS OLGAS™, Aspen HYSYS PIPESYS™, Aspen HYSYS RTO™ Offline, Aspen HYSYS Upstream Dynamics™, Aspen HYSYS Upstream™, Aspen HYSYS®, Aspen HYSYS® , Thermodynamics , COM Interface, Aspen HYSYS®, Aspen HYSYS® , Pipeline Hydraulics , - OLGAS 2-Phase, Aspen HYSYS® , Pipeline Hydraulics , - OLGAS 3-Phase, Aspen HYSYS® , Pipeline Hydraulics , - PIPESYS, Aspen HYSYS® , Offline Optimizer, Aspen HYSYS® , Hydrocracker, Aspen HYSYS® , Reformer, Aspen HYSYS® CatCracker, Aspen HYSYS® Petroleum Refining, Aspen Icarus Process Evaluator®, Aspen Icarus Project Manager®, Aspen In-Plant Cost Estimator, Aspen Kbase®, Aspen MINLP Optimization, Aspen Mixed Integer Optimizer, Aspen Model Runner™, Aspen MPIMS™, Aspen MUSE™, Aspen Online Deployment™, Aspen OnLine®, Aspen OTS Framework, Aspen PIMS Advanced Optimization™, Aspen PIMS Submodel Calculator™, Aspen PIMS™, Aspen Plate Exchanger, Aspen Plate+™, Aspen Plus Dynamics®, Aspen Plus Optimizer™, Aspen Plus®, Aspen Plus® CatCracker, Aspen Plus® Dynamics, Aspen Plus® Hydrocracker, Aspen Plus® Hydrotreater, Aspen Plus® Reformer, Aspen Polymers , Aspen Polymers Plus™, Aspen Process Economic Analyzer, Aspen Process Engineering Console, Aspen Process Development Console,Aspen Process Manual™, Aspen Process Tools™, Aspen Properties®, Aspen Rate-Based Distillation , Aspen RateSep™, Aspen Reaction Modeler, Aspen RefSYS Catcracker™, Aspen RefSYS Hydrocracker™, Aspen RefSYS Reformer™, Aspen RefSYS™, Aspen Shell & Tube Exchanger, Aspen Shell & Tube Mechanical, Aspen Simulation Workbook™, Aspen Solubility Modeler, Aspen Split™, Aspen Tasc+™, Aspen Teams® , Aspen Utilities On-Line Optimizer, Aspen Utilities Operations™, Aspen Utilities Planner™, Aspen Zyqad™ SLM™, SLM Commute™, SLM Config Wizard™, the Aspen leaf logo, and Plantelligence are trademarks or registered trademarks of Aspen Technology, Inc., Burlington, MA.

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

This document is intended as a guide to using AspenTech's software. This documentation contains AspenTech proprietary and confidential information and may not be disclosed, used, or copied without the prior consent of AspenTech or as set forth in the applicable license. Aspen Technology, Inc. Phone: (1) (781) 221-6400 200 Wheeler Road Toll Free: (1) (888) 996-7100 Burlington, MA 01803-5501 Web site: http://www.aspentech.com USA

http://www.aspentech.com/

Contents iii

Contents

1 Introduction.........................................................................................................9 aspenONE Overview ....................................................................................... 9

Installation DVDs ................................................................................. 9 Start Installation .................................................................................10 AspenTech Installation Browser .............................................................10 Aspen Documentation DVD...................................................................10

Installing License Manager Before Installing Applications.....................................11 Installation Process .......................................................................................11 Related Documentation..................................................................................11

aspenONE V7.1 Deployment Guide ........................................................11 Software License Manager (SLM) Installation and Reference Guide .............11 Aspen Engineering What's New V7.1 ......................................................12 Aspen Framework Server V7.1 Installation Manual ...................................12 Aspen Local Security Server V7.1 Installation Manual ...............................12 Aspen Engineering V7.1 Known Issues ...................................................12 Other Related Documents.....................................................................12

Technical Support .........................................................................................12

2 Pre-installation ..................................................................................................15 Overview .....................................................................................................15 Product Name Changes ..................................................................................15 Pre-installation Checklist ................................................................................18 Checking Aspen System Requirements .............................................................19 Aspen Engineering V7.1 Hardware Requirements ...............................................20 Checking Software Requirements ....................................................................20 Checking the Service Pack Version...................................................................21 Checking Virtual Memory................................................................................21 Checking Account Privileges............................................................................21 Checking Product-Specific Requirements and Dependencies ................................21

Aspen Adsorption Additional Requirements..............................................23 Aspen Basic Engineering Additional Requirements ....................................23 Aspen Batch Distillation Additional Requirements .....................................24 Aspen Batch Process Developer Additional Requirements ..........................24 Aspen Chromatography Additional Software Requirements ........................25 Aspen Custom Modeler Additional Software Requirements.........................25 Aspen Economic Evaluation Additional Requirements ................................25 Aspen HYSYS Additional Software Requirements ......................................25 Aspen HYSYS Refining Additional Software Requirements..........................26 Aspen HYSYS Upstream Additional Software Requirements........................26 Aspen OnLine Additional Software Requirements......................................26 Aspen Online Deployment Additional Software Requirements.....................27 Aspen Plus Additional Software Requirements..........................................31

iv 1 Introduction

Aspen Plus CatCracker Additional Hardware Requirements ........................32 Aspen Plus Hydrocracker Additional Hardware Requirements .....................32 Aspen Plus Hydrotreater Additional Hardware Requirements ......................32 Aspen Plus Reformer Additional Hardware Requirements...........................32 Aspen Process Manual Additional Requirements .......................................32 Aspen Properties Additional Software Requirements .................................33 Aspen Reaction Modeler Additional Software Requirements........................34 Aspen Simulation Workbook Additional Software Requirements..................34 Aspen Solubility Modeler Additional Requirements....................................34 Aspen Utilities Planner Additional Software Requirements..........................34 Aspen Utilities On-Line Optimizer Additional Software Requirements ...........35

Recommended Installation Sequence ...............................................................36

3 Installing Aspen Products ..................................................................................37 Overview .....................................................................................................37 SLM Client Tools ...........................................................................................37 Installing Aspen Products ...............................................................................37 Installation Options .......................................................................................37

Valid Aspen Product Installation Options .................................................38 Standard Installation .....................................................................................39

Before You Begin.................................................................................39 Standard Installation Using the Aspen Engineering DVD............................40 Configuring Aspen Products at Install Time .............................................49 Ready to Install...................................................................................51 Setup Complete ..................................................................................52

Client-Server Installation................................................................................53 Overview ...........................................................................................53 Before You Begin.................................................................................53 Client-Server Installation Using the Aspen Engineering DVD ......................54 Installing Aspen Software on a Server ....................................................54 Installing the Software.........................................................................55 Configuring Aspen Products at Install Time .............................................64 Ready to Install...................................................................................66 Setup Complete ..................................................................................67 Installing Aspen Basic Engineering.........................................................67

Configuring a Windows Server as an Aspen Host................................................69 Adding Windows Server Accounts ..........................................................69

Installing Aspen Products on User PCs..............................................................71 Configuring Installed Aspen Products on User PCs..............................................71 Specifying a Remote Server............................................................................71 Verifying Client–Server Communication ............................................................76 Verifying the Installation ................................................................................77 Configuring Installed Aspen Products ...............................................................77

4 Individual Product Installation Notes.................................................................79 Installation Notes..........................................................................................79 Aspen Basic Engineering Installation Notes .......................................................79

Installation Types................................................................................79 Aspen Basic Engineering Standard Installation Notes ................................80 Aspen Basic Engineering Client Installation Notes.....................................81 Aspen Basic Engineering Server Installation Notes ...................................83 Aspen Basic Engineering Server Installation ............................................83

Contents v

Uninstalling and/or Reinstalling .............................................................85 Disconnecting Users from the Server......................................................85

Aspen HYSYS Installation Notes ......................................................................85 Installing OLI Alliance Suite for HEO.......................................................85

Aspen OnLine Installation Notes ......................................................................85 Aspen Online Deployment Installation Notes .....................................................86 Aspen Plus Installation Notes ..........................................................................89

Installation Details for Aspen Plus and Aspen Properties............................89 Installing the Aspen Properties Enterprise Database .................................89 Aspen OLI Interface Installation Notes....................................................90 Installing Alliance Suite for Aspen OLI ....................................................90 OLI Alliance Suite................................................................................91 HardLock Device Driver Installation Script...............................................94

Aspen Process Manual Installation Notes ..........................................................95 Server Configuration Notes:..................................................................95 Application Configuration......................................................................96

Aspen Simulation Workbook Installation Notes ..................................................97 Version Coexistence.............................................................................97 Disabling Add-in by Default...................................................................98

Aspen Utilities Planner Installation Notes ..........................................................98 Aspen Utilities On-Line Optimizer Installation Notes ...........................................98

Computer Configuration (Installation) Type.............................................98 Microsoft Excel Interface Setup .............................................................98

5 Verifying and Configuring Aspen Products .......................................................100 Overview ...................................................................................................100 Aspen Adsorption ........................................................................................101

Verifying an Aspen Adsorption Installation ............................................101 Verifying an Aspen Adsorption Installation that Uses Aspen Properties ......102

Aspen Basic Engineering ..............................................................................103 Verifying an Aspen Basic Engineering Installation...................................103 Configuring Aspen Basic Engineering....................................................106

Aspen Batch Distillation................................................................................106 Verifying an Aspen Batch Distillation Installation ....................................106

Aspen Chromatography................................................................................107 Verifying an Aspen Chromatography Installation ....................................107

Aspen Custom Modeler ................................................................................108 Verifying the Server Installation ..........................................................108 Verifying an Aspen Custom Modeler Installation.....................................108 Verifying an Aspen Custom Modeler Installation with Aspen Properties ......109

Aspen Exchanger Design and Rating ..............................................................110 Verifying an Aspen Exchanger Design and Rating Installation...................110

Aspen HYSYS and Aspen HYSYS Upstream......................................................111 Verifying an Aspen HYSYS Installation ..................................................111

Aspen MUSE...............................................................................................112 Verifying an Aspen MUSE Installation ...................................................112

Aspen OnLine .............................................................................................113 Configuring Aspen OnLine...................................................................113 Verifying an Aspen OnLine Installation..................................................114

Aspen Plus .................................................................................................116 Configuring Microsoft SQL Server or SQL Express...................................116 Verifying the Aspen Properties Enterprise Database Installation ...............117

vi 1 Introduction

Verifying an Aspen Plus/Aspen Polymers Installation ..............................118 Configuring a Windows Server as an Aspen Plus Calculation Server ..........118 Aspen Plus Client/Server Communication..............................................122 Displaying and Stopping a Process.......................................................123 Customizing Aspen Plus Communication ...............................................123 Using the FORTRAN Compiler with Aspen Plus .......................................124 Installing the FORTRAN Compiler .........................................................124 Verifying the Installation of the FORTRAN Compiler ................................125 Aspen OLI Interface...........................................................................126 Verifying an Aspen OLI Interface Installation .........................................126 Verifying an Aspen Distillation Synthesis feature of Aspen Plus Installation 127

Aspen Plus CatCracker/Hydrocracker/ Hydrotreater/Reformer............................129 Configuring an Aspen Plus CatCracker/Hydrocracker/ Hydrotreater/Reformer Installation.......................................................................................129

Aspen Plus Dynamics...................................................................................129 Verifying an Aspen Plus Dynamics Installation .......................................129

Aspen Properties.........................................................................................130 Verifying an Aspen Properties Installation .............................................130 Setting Up the Aspen Properties Web Interface......................................132 Configuring IIS for the Aspen Properties Web Interface...........................132 Setting Up Directory Security ..............................................................133 Providing Access to Out-Of-Process (OOP) COM Objects..........................134 Restricting User Access Using File Permissions.......................................135 Setting Up Properties Web Interface User Folders ..................................135 Running the Aspen Properties Web Interface .........................................136 Configuring Excel for Performing Property Calculations ...........................136

Aspen Remote Simulation Service..................................................................137 Configuring Aspen Remote Simulation Service .......................................137 Running Aspen Remote Simulation Service (ARSS).................................137

Aspen Solubility Modeler ..............................................................................138 Configuring an Aspen Solubility Modeler Installation ...............................138

Aspen Utilities Planner .................................................................................140 Aspen Utilities On-Line Optimizer...................................................................140

Verifying an Aspen Utilities Planner Installation......................................140

6 Adding and Upgrading Aspen Products.............................................................142 Adding Aspen Engineering Products ...............................................................142 Upgrading Aspen Engineering Products...........................................................142

Before You Upgrade...........................................................................142 Product Upgrade Task Summary..........................................................143 Upgrading Aspen Products ..................................................................145 Repairing or Modifying Products ..........................................................145 After You Upgrade .............................................................................145 Re-registering CAPE-OPEN Property Packages .......................................146

7 Repairing Aspen Products ................................................................................148 Overview ...................................................................................................148 Repairing Products and Subfeatures...............................................................148

Setup Complete ................................................................................154

Contents vii

8 Removing Aspen Products................................................................................156 Before You Remove Any Aspen Product ..........................................................156 Overview ...................................................................................................156

Removing Aspen Products ..................................................................156 After You Remove Aspen Products .................................................................163

Using Excel After Uninstalling Aspen Basic Engineering ...........................164

9 Troubleshooting ...............................................................................................166 Common Problems ......................................................................................166

Checking Installation Account Privileges ...............................................166 Other Troubleshooting Tips .................................................................166

Error Messages ...........................................................................................167 License Errors...................................................................................167 Client-Server Installations ..................................................................167

Troubleshooting Installation of Aspen Products ................................................167 Troubleshooting Individual Aspen Products .....................................................168

Troubleshooting Aspen Adsorption, Aspen Chromatography, Aspen Custom Modeler, and Aspen Plus Dynamics ......................................................168 Troubleshooting Aspen Basic Engineering..............................................168 Troubleshooting Aspen Batch Process Developer ....................................171 Troubleshooting Aspen Online Deployment............................................171 Troubleshooting Aspen Plus ................................................................172 Troubleshooting Aspen Remote Simulation Server..................................176 Troubleshooting Aspen Simulation Workbook.........................................177 Troubleshooting Aspen Solubility Modeler .............................................178

10 Glossary .........................................................................................................180

Index ..................................................................................................................182

viii 1 Introduction

1 Introduction 9

1 Introduction

aspenONE Overview All AspenTech products are released on a set of DVDs that will guide you through your installation, regardless of the applications being installed.

This installation guide presents the steps to suite- or product-specific installations only.

Installation DVDs The DVDs associated with the aspenONE release include:

• Aspen Documentation DVD – includes all AspenTech documentation. This includes all manuals (in PDF format) and standalone versions of Help files. This DVD is not used in the installation process, as it is designed for standalone use.

• DVD 1, Aspen Engineering – includes Aspen Administration components (Aspen SLM, Aspen Security, Aspen SLM tools, aspenONE Diagnostics), Aspen PIMS and all Aspen Engineering products.

• DVD 2, Aspen Manufacturing and Supply Chain – includes Aspen Administration components (Aspen SLM, Aspen Security, Aspen SLM tools, and aspenONE Diagnostics), Aspen Manufacturing products (Information Management, Batch, Production Management, and Advanced Process Control), Aspen Petroleum Supply Chain products, Aspen Chemical Supply Chain products, Aspen Supply and Distribution and Aspen Infrastructure products.

Notes:

• Some products previously available on CD-ROM or DVD are not included on the aspenONE DVD product discs. If you do not find a product included on the aspenONE DVD product discs, please contact AspenTech Support at http://support.aspentech.com.

• Third-party products that AspenTech delivers without any modification of the software are delivered in their original packages.

http://support.aspentech.com/

10 1 Introduction

Start Installation To begin an installation, insert the appropriate DVD into your DVD drive. You will be prompted to configure your license information prior to installation. Aspen Administration components (SLM Server and Aspen Security (Aspen Framework)) and some Aspen Engineering products do not require a license to install. For all others, you must configure the license information before you can install. When the products are determined to have valid licenses, the AspenTech Installation Browser will request the products or product set that you want to install and request applicable DVDs as needed. Alternatively, DVD content can be shared from a network server.

AspenTech Installation Browser The AspenTech Installation Browser provides a mechanism for users to validate their product licenses and browse through the products that they are licensed for prior to installation. The AspenTech Installation Browser contains two tabs, Administration and Products.

From the Administration tab, you can install the Aspen Administration products – Aspen SLM, Aspen Security (Aspen Framework), Aspen SLM tools, and aspenONE Diagnostics.

From the Products tab, you can browse for and install individual products. The Installation Browser will guide you in determining your licensed products based on your license configuration.

The AspenTech Installation Browser also includes links to Aspen Technology support centers and web sites for contact information, product updates and other resources. A link is also provided to easily access the license configuration wizard to determine which products you are licensed for installation.

Clicking Install starts the process during which you will select the products to be installed on your computer.

For more information, see the aspenONE Deployment Guide.

Aspen Documentation DVD Before installing any AspenTech product, be sure to print and read the installation guide and release notes documentation for each product you intend to install. All AspenTech installation and reference documents (in PDF format) and standalone versions of Help files are included on the aspenONE Documentation DVD.

Each product-specific installation guide contains critical information about system requirements, product dependencies, and post-installation configuration procedures. The release notes for each product contain information on new features, software fixes, and known problems and workarounds.

1 Introduction 11

Installing License Manager Before Installing Applications Normally you may need to install SLM (Software License Manager) products before installing Aspen applications. For information on how to install SLM (Software License Manager) products, see Software License Manager (SLM) Installation and Reference Guide, which is contained on the Documentation DVD.

Installation Process To begin an installation, insert any DVD into your DVD drive. The AspenTech Installer requests the products or product set that you want to install and requests applicable DVDs. Alternatively, DVD content can be shared from a network server.

To install Aspen Engineering Products, insert DVD 1.

For example, if you are performing a new installation of Aspen Engineering products only, the AspenTech Installer installs infrastructure components (using the Infrastructure DVD) followed by Aspen Engineering components.

Note: All product documentation is automatically installed during a suite or product installation.

Related Documentation Note: All documentation is contained on the Documentation DVD.

aspenONE V7.1 Deployment Guide aspenONE V7.1 Deployment Guide provides an overview of the installation options and details about the installation process.

Software License Manager (SLM) Installation and Reference Guide Software License Manager (SLM) Installation and Reference Guide, the license manager software used with aspenONE.

Note: You must install and enable Software License Manager (SLM) before installing Aspen products.

12 1 Introduction

Aspen Engineering What's New V7.1 Aspen Engineering What's New V7.1 highlights new products and features with the aspenONE release of the Aspen Engineering .

Aspen Framework Server V7.1 Installation Manual Aspen Framework Server V7.1 Installation Manual, which is contained on the Documentation DVD, provides step-by-step instructions for installing and configuring Aspen Framework.

Aspen Local Security Server V7.1 Installation Manual Aspen Local Security Server V7.1 Installation Manual, which is contained on the Documentation DVD, provides step-by-step instructions for installing and configuring the Aspen Local Security (ALS) Server, which provides role-based security for AspenTech point solutions.

Aspen Engineering V7.1 Known Issues Aspen Engineering V7.1 Known Issues describes known issues and workarounds for Aspen Engineering products.

Other Related Documents Installation Guides for individual Aspen Manufacturing and Supply Chain products are on the Documentation DVD.

Note: For Aspen PIMS Installation information, see the Documentation DVD.

Technical Support AspenTech customers with a valid license and software maintenance agreement can register to access the online AspenTech 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 service packs and product updates

• Submit and track technical issues

• Send suggestions

• Report product defects

http://support.aspentech.com/

1 Introduction 13

• Review lists of known deficiencies and defects

Registered users can also subscribe to our Technical Support e-Bulletins. These are used to alert users to important technical support information such as:

• Technical advisories

• Product updates and releases

Customer support is also available by phone, fax, and email. The most up-to-date contact information is available at the AspenTech Support Center at http://support.aspentech.com.

14 1 Introduction

2 Pre-installation 15

2 Pre-installation

Overview This chapter provides an overview of the installation requirements and installation options.

Product Name Changes With the release of aspenONE V7.0, AspenTech made the decision to provide more functional names to several of its Process Engineering products. The new names reflect the function/role that each product performs as part of the overall Aspen Engineering. The installation has also been re-organized to reflect functional groups. Use the chart below to see the new product names and their corresponding installation selections.

Product Name Release 2006.5

Product Name V7.0

Install Mapping (What to Install)

Required Install Option Selection

Aspen Acol+™ Aspen Air Cooled Exchanger

Exchanger Design And Rating

---

Aspen Adsim® Aspen Adsorption Process Modeling (Aspen Plus)

Advanced Simulation Options

Aspen Batch Plus® Aspen Batch Process Developer

Process Development ---

Aspen BatchSep™ Aspen Batch Distillation (includes reaction modeling functionality)

Process Development Advanced Modeling Options

Process Modeling (Aspen Plus)


Aspen CatRef® Aspen Plus® Reformer

Aspen Plus Based Refinery Reactors

---

Aspen Chromatography®

Aspen Chromatography®


16 2 Pre-installation


Product Name V7.0



Aspen COMThermo®

Aspen HYSYS® Thermodynamics COM Interface

Process Modeling (HYSYS)

Energy and Flare Analysis

Aspen Custom Modeler®

Aspen Custom Modeler®





Aspen Dynamics® Aspen Plus® Dynamics



Aspen FCC® Aspen Plus® CatCracker


---

Aspen FiredHeater Aspen Fired Heater Exchanger Design and Rating

---

Aspen FLARENET™ Aspen Flare System Analyzer





Aspen HTFS Research Network™

Aspen HTFS Research Network™

Exchanger Design and Rating

---

Aspen HX-Net® Aspen Energy Analyzer





Aspen Hydrocracker®

Aspen Plus® Hydrocracker


---

Aspen Hydrotreater™

Aspen Plus® Hydrotreater


---

Aspen HYSYS® Aspen HYSYS® Process Modeling (HYSYS)

---

Aspen HYSYS Amines™

Aspen HYSYS Amines™


---

Aspen HYSYS Dynamics™

Aspen HYSYS Dynamics™


---

Aspen HYSYS OLGAS™

Aspen HYSYS® Pipeline Hydraulics - OLGAS 2-Phase


---

Aspen HYSYS OLGAS 3-Phase™

Aspen HYSYS® Pipeline Hydraulics - OLGAS 3-Phase


---

Aspen HYSYS PIPESYS™

Aspen HYSYS® Pipeline Hydraulics

- PIPESYS


---

Aspen HYSYS RTO™ Offline

Aspen HYSYS® Offline Optimizer


---

Aspen HYSYS Upstream™

Aspen HYSYS Upstream™


---

Aspen HYSYS Upstream

Aspen HYSYS Upstream


---



Product Name V7.0



Dynamics™ Dynamics™

Aspen Icarus Process Evaluator®

Aspen Process Economic Analyzer

Economic Evaluation ---

Aspen Icarus Project Manager®

Aspen In-Plant Cost Estimator


Aspen Kbase® Aspen Capital Cost Estimator


Aspen MPIMS™ Aspen MPIMS™ Aspen PIMS ---

Aspen Model Runner™

Aspen Model Runner™



Aspen MUSE™ Aspen MUSE™ --- ---

Aspen OnLine® Aspen OnLine® --- ---

Aspen Online Deployment™

Aspen Online Deployment™

Operations Support Aspen Online Deployment

Aspen PIMS™ Aspen PIMS™ Aspen PIMS ---

Aspen PIMS Advanced Optimization™

Aspen PIMS Advanced Optimization™

Aspen PIMS ---

Aspen PIMS Submodel Calculator™

Aspen PIMS Submodel Calculator™

Aspen PIMS ---

Aspen Plate+™ Aspen Plate Exchanger

Exchanger Design and Rating

---

Aspen Plus® Aspen Plus® Process Modeling (Aspen Plus)

---

Aspen EO Model Library (Equation-Oriented HYSYS)

Aspen EO Model Library (Equation-Oriented HYSYS)



Aspen Plus Optimizer™

Aspen Plus Optimizer™


---



Aspen Polymers Plus™

Aspen Polymers Process Modeling (Aspen Plus)

---

Aspen Process Manual™

Aspen Process Manual™

Process Development (Server Install only)

---

Aspen Process Tools™

Aspen Process Tools™


Aspen Properties® Aspen Properties® Process Modeling (Aspen Plus) or Process Development

---

Aspen RateSep™ Aspen Rate-Based Distillation


---

Aspen RefSYS™ Aspen HYSYS® Petroleum Refining


Aspen RefSYS Catcracker™

Aspen HYSYS® CatCracker





Product Name V7.0



Aspen RefSYS Hydrocracker™

Aspen HYSYS® Hydrocracker



Aspen RefSYS Reformer™

Aspen HYSYS® Reformer



Aspen Simulation Workbook™

Aspen Simulation Workbook™

Operations Support Aspen Simulation Workbook


Aspen Simulation Workbook


Aspen Simulation Workbook

Aspen Split™ Aspen Distillation Synthesis


---

Aspen Tasc+™ Aspen Shell & Tube Exchanger


---

Aspen Teams® Aspen Shell & Tube Mechanical


---

Aspen Utilities Operations™

Aspen Utilities On-Line Optimizer



Aspen Utilities Planner™

Aspen Utilities Planner™



Aspen Zyqad™ Aspen Basic Engineering

Aspen Basic Engineering

---

NEW Aspen OTS Framework

Operations Support Aspen OTS Framework

NEW Aspen Process Engineering Console


---

NEW Aspen Solubility Modeler


NEW (V7.1) Aspen Process Development Console


Pre-installation Checklist Before installing any Aspen Engineering product, review the following checklist to ensure a smooth installation.

• Verify that all system requirements are met. For instructions, see ”Checking Aspen System Requirements."

• Verify that all additional required software has been installed. For instructions, see "Checking Software Requirements."

• Verify that all additional product-specific requirements and dependencies are met. For instructions, see “Checking Product-Specific Requirements and Dependencies."


• Check which service pack (SP) is installed. For instructions, see "Checking the Service Pack Version."

• Verify that the virtual memory, including swap space is sufficient for running Aspen products. For instructions, see “Checking Virtual Memory."

• Verify that the installation account has local Administrator privileges. For instructions, see “Checking Account Privileges."

• Verify that SLM is available. For instructions, see Software License Manager (SLM) Installation and Reference Guide, which is contained the Documentation DVD.

• Disable any anti-virus software running on your PC so that the installation program can copy files to the system area and modify the Windows Registry. After you complete the installation, enable the anti-virus software.

• Verify that all additional product-specific requirements and dependencies are met. For instructions, see “Checking Product-Specific Requirements and Dependencies."

• Check which service pack (SP) is installed. For instructions, see "Checking the Service Pack Version."

• Verify that the virtual memory, including swap space is sufficient for running Aspen products. For instructions, see “Checking Virtual Memory."

• Verify that the installation account has local Administrator privileges. For instructions, see “Checking Account Privileges."

• Verify that SLM is available. For instructions, see Software License Manager (SLM) Installation and Reference Guide, which is contained the Documentation DVD.

• Disable any anti-virus software running on your PC so that the installation program can copy files to the system area and modify the Windows Registry. After you complete the installation, enable the anti-virus software.

Checking Aspen System Requirements This section provides the hardware and software requirements for the Aspen Engineering products.


Aspen Engineering V7.1 Hardware Requirements

Requirement Specification

Minimum Requirements Intel® 1.00GHz or higher, DVD ROM, 40 GB, 1 GB RAM on XP, 2 GB RAM on VISTA

Recommended Intel® Core™2 Duo 2.00GHz or higher, DVD-ROM, 250 GB, 3 GB RAM or higher

Operating System Desktop:

Windows XP SP3 with Office 2003 SP3 Windows Vista Business SP1 with Office 2007 SP1 Windows Vista Enterprise SP1 with Office 2007 SP1 Server:

Windows Server 2003 R2 SP2 Standard Edition with Office 2003 SP3 Windows Server 2008 Standard 32 Bit with Office 2007 SP1

Disk Space The programs require about 5 GB when all Aspen Engineering functionality is installed. Additional space may be required while installing so about 10 GB of free space is recommended. Additionally programs generated temporary files that may occupy space depending on how you use the programs.

Checking Software Requirements The following software requirements apply to all Aspen products.

• MS Office 2003 SP3 (XP only)

• MS Office 2007 SP1 (Vista only)

• Internet Explorer 6 SP2 (XP only)

• Internet Explorer 7 (Vista only)

• Adobe Reader Version 4 or higher

Certain functionality requires you to install 3rd party programs such as Intel Fortran, or Visual Studio Compiler, and so on. Details of such 3rd party program prerequisites are covered in individual product installation sections

With the exception of Aspen OnLine and Aspen Process Tools (which are supported only on English operating systems), all products are supported on English, German, Japanese, and Chinese versions of the operating systems. Additionally, Aspen Batch Process Developer is supported on French operating systems.

Unsupported language versions of these operating systems may or may not work and are not tested.


Checking the Service Pack Version To check which Service Pack version is installed

• On the desktop, click Start | Settings | Control Panel; then double-click System.

The General tab of System Properties dialog displays the installed version of Windows and any service pack information.

Checking Virtual Memory The recommended amount of virtual memory (physical memory plus swap file) is 1 Gigabyte. Large plant models or multiple open applications may require additional virtual memory. For information on checking Virtual Memory, see your Microsoft documentation.

Checking Account Privileges When installing Aspen products, you must use an account with Local Administrator privileges. For information on checking Account Privileges, see your Microsoft documentation.

Checking Product-Specific Requirements and Dependencies Some Aspen products have specific pre-installation requirements that must be met before installing the product.

The following table shows which Aspen products have additional hardware and/or software requirements and which do not. The additional requirements are shown below.

This product has additional pre-installation requirements

Aspen Adsorption V7.1 Yes

Aspen Basic Engineering V7.1 Yes

Aspen Batch Distillation V7.1 Yes

Aspen Batch Process Developer V7.1 Yes

Aspen Chromatography V7.1 Yes

Aspen Custom Modeler V7.1 Yes


This product has additional pre-installation requirements

Aspen Distillation Synthesis V7.1 feature in Aspen Plus

No

Aspen Economic Evaluation V7.1 Yes

Aspen Energy Analyzer V7.1 No

Aspen Exchanger Design and Rating V7.1

Aspen Shell & Tube Exchanger V7.1

Aspen Air Cooled Exchanger V7.1

Aspen Fired Heater V7.1

Aspen Plate Exchanger V7.1

Aspen HTFS Research Network V7.1

Aspen Shell & Tube Mechanical V7.1

Aspen Hetran V7.1

Aspen Aerotran V7.1

No

Aspen Flare System Analyzer V7.1 No

Aspen HTFS V7.1

Aspen MUSE V7.1

No

Aspen HYSYS V7.1 No

Aspen HYSYS Refining V7.1 Yes

Aspen HYSYS Upstream V7.1 Yes

Aspen Model Runner V7.1 No

Aspen OnLine V7.1 Yes

Aspen Online Deployment V7.1 Yes

Aspen OTS Framework No

Aspen Plus V7.1 Yes

Aspen Plus CatCracker V7.1 Yes

Aspen Plus Dynamics V7.1 No

Aspen Plus Hydrocracker V7.1 Yes

Aspen Plus Hydrotreater V7.1 Yes

Aspen Plus Reformer V7.1 Yes

Aspen Polymers V7.1 No

Aspen Process Development Console V7.1 No

Aspen Process Engineering Console V7.1 No

Aspen Process Manual V7.1 Yes

Aspen Process Tools V7.1 No

Aspen Properties V7.1 Yes

Aspen Reaction Modeler Yes

Aspen Remote Simulation Service V7.1 No

Aspen Simulation Workbook V7.1 No

Aspen Solubility Modeler Yes


Aspen Adsorption Additional Requirements

Software Requirements Requirements Notes

Intel Fortran 9.0 or 9.1

Required for customer development of Fortran procedures.

Aspen Basic Engineering Additional Requirements

Hardware Requirements

Client Hardware Resource Recommended Requirements

CPU Intel Pentium III 750 MHz (or faster) processor.

Note: If you are purchasing a new computer, select the fastest CPU available.

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

Physical Memory 512 Mb RAM (minimum), 768 MB or higher for large plant models.

Hard Disk Space 512Mb minimum (1Gb recommended) of free disk space on each PC to be installed with this release.

Note: The Installer displays space requirements for the selected products.

Virtual memory 512 MB consisting of physical memory and swap file.

Pointing device A mouse or other pointing device.

DVD-ROM drive Available on the local PC or through the network during the installation.

Server Hardware Resource Requirements

CPU 1 GHz minimum (2 to 3 GHz recommended).

The Aspen Basic Engineering Server combined with Oracle does not perform well on a machine with less than a 1 GHz clock speed. (Oracle or SQL Server is required to run Aspen Basic Engineering, see Software Requirements below.) There are two modes you can use:

Two-tier mode: (RDB Server and Aspen Basic Engineering Server run on the same host). (Follow the Relational Database (RDB) product guidelines for additional system requirements and add these to the overall Server system requirements if possible.) The RDB,


especially Oracle, combined with the Aspen Basic Engineering Server will not perform well on a machine with less than a 1 GHz clock speed. At least 2 GHz is recommended.

Three-tier mode: (the RDB exists on a separate PC). The RDB does not greatly influence the middle tier hosting the Aspen Basic Engineering Server other than some additional memory to operate its cache on the middle tier. You should use a fast LAN connection between the Aspen Basic Engineering Server and RDB Server (100 BaseT recommended).

Aspen Basic Engineering V7.1 exploits multiple processor server hardware. Adding additional processors can improve server response times.

Physical Memory 1 GB RAM minimum (2 GB recommended)

Hard Disk Space 2 GB (recommended)

DVD Drive

Aspen Batch Distillation Additional Requirements Component Notes

Aspen Properties V7.1 Aspen Properties must be installed. This is required to enable Aspen Batch Distillation to perform physical property calculations. You do not require an Aspen Properties license to use Aspen Properties from within Aspen Batch Distillation.

Aspen Batch Process Developer Additional Requirements

Software Requirements Requirements Notes

Aspen Plus V7.1 with BatchFrac enabled

Required to run BatchFrac model.

Aspen Plus V7.1 and Aspen Plus Dynamics V7.1

Required to run Kinetic Reactor model.

Microsoft Project 2003 or 2007

Microsoft Project 2003 or 2007

Visio Professional 2003 or 2007

Visio Professional 2003 or 2007

ChemDraw 9.0 or 10.0, or ISIS/Draw 2.5

Required to view Chemist Recipe document.


Aspen Chromatography Additional Software Requirements Resource Requirements

Intel Fortran 9.0 or 9.1 Required for customer development of Fortran procedures.

Aspen Custom Modeler Additional Software Requirements Requirements Notes

Intel Fortran 9.0 or 9.1

Required for customer development of Fortran procedures.

Microsoft Visual C++ 2005

Required for customer development of C/C++ procedures, or to export models for use in Aspen Plus or HYSYS.

Microsoft Visual Basic 6 or 2005

Required to create custom forms within Aspen Custom Modeler.

Aspen Economic Evaluation Additional Requirements Requirements Notes

Internet Explorer 5.0 or higher Required for certain reports in all Aspen Economic Evaluation products.

Microsoft Excel 2000 or later Required for Aspen Decision Analyzer and certain reports in all other Aspen Economic Evaluation products.

Primavera Enterprise Project Manager (P3e), Primavera Integration API, and Java Runtime Environment or Java Development kit.

Required for scheduling component of Aspen Icarus Project Scheduler (IPS). P3e, the Primavera Integration API, and Java components must be installed and configured prior to successful operation of IPS. For further information, see related Primavera installation documents and the Icarus Project Scheduler Installation Guide.pdf which provides an installation/configuration checklist.

Primavera Project Planner for Windows (P3) 3.1

Required for scheduling component of Aspen In-Plant Cost Estimator. P3 must be installed prior to installing Aspen In-Plant Cost Estimator. For instructions, see the Primavera Project Planner for Windows Reference (version 3.0), pages xxii-xxxiii, “Setting up P3.”

Aspen HYSYS Additional Software Requirements Requirements Notes

Aspen Exchanger Design and

Required for detailed heat exchanger analysis.

Note: To install Aspen Exchanger Design and Rating V7.1, click the Exchanger Design and Rating option under Process Modeling


Rating V7.1 (HYSYS).

Aspen Economic Evaluation V7.1

Required to perform Capital Cost Estimation calculations.

Note: To install Aspen Economic Evaluation V7.1, click the Economic Evaluation option under Process Modeling (HYSYS).

Aspen HYSYS Refining Additional Software Requirements Requirements Notes

CrudeManager RefSYS Link LE or CrudeManager RefSYS Link

This feature lets you import assays from a special version of CrudeManager - the assay management system from Spiral Software Ltd. To obtain CrudeManager RefSYS Link LE or CrudeManager RefSYS Link, contact your local AspenTech Support.

Aspen PIMS Required to transfer Sub-model calculator files from Aspen PIMS to Aspen RefSYS.

Aspen HYSYS Upstream Additional Software Requirements Requirements Notes

Prosper GAP Required to run GAP unit operation

PIPESIM 2003 or higher PIPESIM 2003 or higher is required for the PIPESIM Link and PIPESIM Net unit operations.

OLGA from SPT Group Required to run the HYSYS OLGA link

Aspen OnLine Additional Software Requirements Requirements Notes

Aspen Plus V7.1 Required if the model driven by Aspen OnLine is an Aspen Plus simulation model. A complete installation of the Aspen Plus application should be installed on the computer running Aspen OnLine Server.

Aspen Custom Modeler V7.1

Aspen Adsorption V7.1

Aspen Chromatography V7.1

For a model to be driven by Aspen OnLine, the successful installation of the corresponding product and application on the computer running Aspen OnLine Server is required.

CIM-IO Server

CIM-IO server must be available to serve data residing on the DCS or information management system like InfoPlus 21, PHD, or PI.

Note: CIM-IO client component is installed automatically with Aspen OnLine (standard install) when the server component is selected.

Microsoft Excel 2000 or Required by both Aspen OnLine Server and Client GUI.


higher

Microsoft Access 2000 or higher

Optional

Aspen Process Explorer Optional (Tag browser can be used together with Aspen OnLine to easily add tags)

Aspen Online Deployment Additional Software Requirements Requirement Comments

Aspen HYSYS 2004.2 or later

HYSYS is needed to run HYSYS models online. HYSYS MUST be installed on any system that uses Aspen Online Deployment to create or maintain Aspen Online Deployment online applications. HYSYS must be installed on any system that solves the Aspen HYSYS model on behalf of an online application (this could be the system running the Online Deployment application server, or it could be a system running the Aspen Remote Simulation Service).

Note: For versions of HYSYS prior to 2006.5: In order to install all the required components, use the Standard option to install HYSYS and select all subfeatures. With version 2006.5 or later, either Standard or Server can be used.

Aspen HYSYS 2006.5 or later (dynamic and steady state)

HYSYS is needed to run HYSYS dynamic or steadystate models online. HYSYS MUST be installed on any system that uses Aspen Online Deployment to create or maintain Aspen Online Deployment online applications. HYSYS must be installed on any system that solves the Aspen HYSYS model on


behalf of an online application (this could be the system running the Online Deployment application server, or it could be a system running the Aspen Remote Simulation Service).

Note: For versions of HYSYS prior to 2006.5: In order to install all the required components, use the Standard option to install HYSYS and select all subfeatures. With version 2006.5, either Standard or Server can be used.

Aspen Plus 2004.2 or later

Aspen Plus is needed to run Aspen Plus models online. Aspen Plus must be installed on any system that uses Aspen Online Deployment to create or maintain Aspen Online Deployment online applications. Aspen Plus must be installed on any system that solves the Aspen Plus model on behalf of an online application (this could be the system running the Online Deployment application server, or it could be a system running the Aspen Remote Simulation Service).

Note: For versions of Aspen Plus prior to 2006.5: In order to install all the required components, use the Standard option to install Aspen Plus and select all subfeatures. With version 2006.5, either Standard or Server can be used.

Aspen Custom Modeler 2004.2 or later

Aspen Custom Modeler (ACM) is needed to run ACM models online. ACM will need to be installed on any system that uses Aspen Online Deployment to create or maintain Aspen Online


Deployment online applications. ACM will need to be installed on any system that solves the ACM model on behalf of an online application (this could be the system running the Online Deployment application server, or it could be a system running the Aspen Remote Simulation Service).

Note: For versions of Aspen Custom Modeler prior to 2006.5: In order to install all the required components, use the Standard option to install Aspen Custom Modeler and select all subfeatures. With version 2006.5, either Standard or Server can be used.

Aspen HTFS+ 2006.5 or later

Aspen HTFS+ is needed to run Aspen HTFS+ models online.

Aspen Online Deployment can execute Aspen Shell & Tube Exchanger (Tasc+), Aspen Air Cooled Exchanger (Acol+), Aspen Plate Exchanger (Plate+) and Aspen Fired Heater (FiredHeater) models online. The exchanger design and rating file (EDR file) must contain only one heat exchanger definition.

Aspen HTFS+ must be installed on any system


that uses Aspen Online Deployment to create or maintain Aspen Online Deployment online applications. Aspen HTFS+ must be installed on any system that solves the Aspen HTFS+ model on behalf of an online application (this could be the system running the Online Deployment application server, or it could be a system running the Aspen Remote Simulation Service).

Aspen Remote Simulation Service V7.1

Aspen Remote Simulation Service must be installed on a server computer that will solve HYSYS, Aspen Plus, HTFS+, or Aspen Custom Modeler models on behalf of Aspen Online Deployment applications running on the same or a different server computer.

Aspen CIM-IO 2006.5 (on the Aspen Manufacturing Suite DVD)

Aspen CIM-IO is required on the server computer hosting Aspen Online Deployment online applications. It is not required on a computer that will only run the Aspen Online Deployment Desktop.

Aspen Process Data 2006.5 (on the Aspen Manufacturing Suite DVD)

Aspen Process Data is required on the server computer hosting Aspen Online Deployment online applications. It is not required on a computer that will only run the Aspen Online Deployment Desktop.

Aspen Data Source Architecture 2006.5 (on the Aspen

Aspen Online Deployment will only use Process Data sources configured on a public ADSA data source directory server. If you do not already have an ADSA directory server that you


Manufacturing Suite DVD)

plan to use, then you must install one and configure the Aspen Online Deployment online application server to use it.

Aspen Production Control Web Server 2006.5 (on the Aspen Manufacturing Suite DVD)

Aspen PCWS is required to be installed on a web server if you wish to use PCWS to view and interact with Aspen Online Deployment online applications.

Aspen Local Security 2006.5 (on the Aspen Manufacturing Suite DVD) or Aspen Framework Server (on the Aspen Manufacturing Suite DVD)

The Aspen Online Deployment online application server and Aspen PCWS use Aspen Framework (AFW) Security to provide role-based authorization of access to the online applications. You must either configure the online application server and web server systems to use an existing AFW Security server, or you must install one. You can either install Aspen Local Security or an Aspen Framework Server.

Aspen Plus Additional Software Requirements Requirements Notes

Intel Fortran 9.1 Standard or Professional, with a linker

Required for customer development of Fortran models. Linker may be: • Microsoft Visual Studio 2003 or later, or • The free Microsoft Visual C++ Express 2005 or later

It is also possible to use Compaq Visual Fortran (6.6a) or other versions of Intel Fortran 9.0 or later, with some limitations. See Aspen Plus User Models for details.

Microsoft SQL Server 2005 or 2008, or Microsoft SQL Express 2005, and a non-compressed drive for storing SQL databases.

Required to use the Aspen Properties Enterprise Database. (Microsoft SQL Express is installed with Aspen Properties if none of these servers is already installed.) If SQL Server or SQL Express is already installed, it must be configured to use SQL Server and Windows authentication mode. See Configuring Microsoft SQL Server or SQL Express.

Aspen Properties no longer uses Microsoft SQL Server Desktop Edition (MSDE) or SQL Server 2000, even if it is already installed, due to problems encountered with these SQL servers.

FactSage 5.1 or 5.5

Used to generate ChemSage files for the ChemApp interface; need not be on the same computer with Aspen Plus.

ChemApp 5.3.2 Required to use FACT/ChemApp interface for pyrometallurgical processes.


Required for detailed heat exchanger analysis.

Note: To install Aspen Exchanger Design and Rating V7.1, click the Aspen Exchanger Design and Rating option under Process Modeling (Aspen Plus).

Macromedia Flash Player 5 or later

Required to view the viewlets in online help. If you do not have Flash Player installed, visit http://www.macromedia.com/go/getflashplayer to install it.

Aspen Economic Evaluation V7.1

Required to perform Capital Cost Estimation calculations.

Note: To install Aspen Economic Evaluation V7.1, click the Economic Evaluation option under Process Modeling (Aspen Plus).

Windows XP Required for Aspen OLI Interface


Professional

Note: When you install Aspen Plus, the separately licensed Aspen Plus Optimizer is installed automatically.

Aspen Plus CatCracker Additional Hardware Requirements Resource Requirements

Physical Memory Minimum of 512 MB.

Virtual Memory 1 GB.

Aspen Plus Hydrocracker Additional Hardware Requirements Resource Requirements



Aspen Plus Hydrotreater Additional Hardware Requirements Resource Requirements



Aspen Plus Reformer Additional Hardware Requirements Resource Requirements



Aspen Process Manual Additional Requirements

For Aspen Process Manual Server:

Hardware Requirements Notes

Hard Disk Space Up to 1.2GB free disk space, depending upon the number of


technical areas installed

Software Requirements Notes

Internet Information Server (IIS)

Required to run the product; must be installed first.

ASP Required to run the product; must be installed first.

For Aspen Process Manual Client:

Software Requirements Notes

Internet Explorer 5 or Later

Client must be configured to allow session cookies.

Java Virtual Machine Client must be configured to allow session cookies.

Active X Controls Some content uses signed Active X controls; these may be disabled for the application, but functionality will be reduced.

Adobe Acrobat Reader Required for some content

Other Browsers May work, provided they have support for JavaScript.

Aspen Properties Additional Software Requirements Requirements Notes

Intel Fortran 9.1, Standard or Professional, with a linker

Required for customer development of Fortran models. Linker may be: • Microsoft Visual Studio 2003 or 2005, or • Microsoft Visual C++ Express 2005

It is also possible to use Compaq Visual Fortran (6.6a) or other versions of Intel Fortran 9.0 or later, with some limitations. See Aspen Plus User Models for details.

Microsoft SQL Server 2000 or 2005, or Microsoft SQL Express, and a non-compressed drive for storing SQL databases.

Required to use the Aspen Properties Enterprise Database. (Microsoft SQL Express is installed with Aspen Properties if none of these servers is already installed.) If SQL Server or SQL Express is already installed, it must be configured to use SQL Server and Windows authentication mode. See Configuring Microsoft SQL Server or SQL Express.

Aspen Properties no longer uses Microsoft SQL Server Desktop Edition (MSDE), even if it is already installed, due to numerous problems encountered with this SQL server.

MDAC 2.8 SP1 or later Required before Microsoft SQL Express can be installed.


Aspen Reaction Modeler Additional Software Requirements Requirements Notes

Aspen Properties V7.1 Aspen Properties must be installed. This is required to enable Aspen Reaction Modeler to perform rigorous physical property calculations. You do not require an Aspen Properties license to use Aspen Properties from within Aspen Reaction Modeler.

Aspen Simulation Workbook Additional Software Requirements Requirements Notes

Microsoft Excel 2000 or later Windows 2003, XP, or Vista

Required to use the Aspen Simulation Workbook.

If using Excel 2003, Microsoft KB 907417 is required.

Aspen Plus V7.1

Aspen HYSYS V7.1

Aspen Custom Modeler V7.1

Aspen Plus Dynamics V7.1

Aspen Chromatography V7.1

Aspen Adsorption V7.1


Required to use models from these products within the Aspen Simulation Workbook.

Aspen Solubility Modeler Additional Requirements Requirements Notes

Aspen Properties V7.1 Required to run the product; must be installed prior to or simultaneously with Aspen Solubility Modeler. (Installed as part of the Process Development module.)

Aspen Utilities Planner Additional Software Requirements Requirements Notes

Microsoft Excel 2003 or 2007

Used for reports. If using Excel 2003, Microsoft KB 907417 is required.

Microsoft Access 2003, 2007

One of these databases is required to run Aspen Utilities Planner and Aspen Utilities On-Line Optimizer.


Aspen Utilities On-Line Optimizer Additional Software Requirements Requirements Notes

Aspen Online Required to connect Aspen Utilities Planner to online data and to control execution of Aspen Utilities Planner

CIM-IO Used to transfer data between AspenTech products and external devices.

Microsoft Excel 2003 or 2007

Used for reports.

Microsoft Access 2003 or 2007

One of these databases is required to run Aspen Utilities Planner and Aspen Utilities On-Line Optimizer.

Software Requirements

Non-AspenTech Software

Component Additional Requirements

Microsoft SQL Server 2000

-or-

Oracle 9i Enterprise Edition – Version 9.2

Service Pack 3a

One of these Relational Databases is required to run Aspen Basic Engineering V7.1 to operate as a transactioned backing store (the contents of these cannot designed to be queried by the user). These products can be installed before or after installing Aspen Basic Engineering. The RDB software can be installed either on the Aspen Basic Engineering Server host machine, or on a separate machine on the same local area network.

For Oracle, you must install Oracle OLEDB Client on the Aspen Basic Engineering Server host machine.

Important Note: Only a correct and corresponding Oracle driver/client should be used in conjunction with the Oracle server.

Never mix Oracle client/driver versions and server versions

Severe maloperation can result by mixing driver and RDBMS versions from different Oracle installations.

Microsoft Access (optional)

Note: Aspen Basic Engineering installations can be tested with Microsoft Access (which can also be used for some customization work that can be done independently of the final deployment environment). Microsoft Access must not be used in the deployment of Aspen Basic Engineering onto engineering projects for reasons of data security in a transactioned environment.

Microsoft Office 2000

-or-

Microsoft Office XP

-or-

Microsoft Office 2007

Service Pack 3

Service Pack 3

Microsoft Excel is required for the Datasheet Definer and the Excel Datasheet Generator.

Microsoft Internet IE 6.0 uses scrrun.dll version 5.6.0.6626, which is required.


Explorer 6.0 This component is bundled with Internet Explorer 6.0, Windows XP (Professional or Home), and Visual Studio 2002 or 2003.

Pro/II v6.0, 6.01

HTRI XIST

Recommended Installation Sequence Before you begin to install any Aspen Engineering software, we recommend that the SLM Server is installed, configured, and available. This is typically done by your System Administrator.

Note: Normally you need to install SLM (Software License Manager) products before installing Aspen applications. For information on how to install SLM (Software License Manager) products, see Software License Manager (SLM) Installation and Reference Guide, which is on the Documentation DVD.

3 Installing Aspen Products 37

3 Installing Aspen Products

Overview This Guide covers installation of Aspen Engineering products when installed by clicking the Products tab on the Installation Browser. For information on installing by using the Applications tab, see aspenONE V7.1 Deployment Guide.

SLM Client Tools When installing the Aspen Engineering products, you can also install the SLM (Software License Manager) Client Tools. For information about these SLM client tools, see Software License Manager (SLM) Installation and Reference Guide.

Installing Aspen Products This version of the Aspen Engineering Application Products is contained on DVD 1, Aspen Engineering.

Note: If you are prompted to do so, restart your computer at the end of the installation.

Installation Options There are two options for installing Aspen Engineering products:

• The Standard option installs all files to the local hard drive of a computer. The computer can be a stand-alone or network PC with enough space and power on the local drive to store and run the installed products.

For detailed installation instructions, see "Standard Installation."

38 3 Installing Aspen Products

• The Server option installs files on a central server machine. Products supporting this configuration usually put computing intensive or main data processing activities on the server machine.

For detailed installation instructions, see "Client-Server Installation."

Note: Not all products have both options.

Valid Aspen Product Installation Options The following table summarizes the valid installation options for each Aspen product.

Aspen Product Installation Options

Standard Server

Aspen Adsorption V7.1 Yes Yes

Aspen Batch Process Developer V7.1 Yes No

Aspen Batch Distillation V7.1 Yes No

Aspen Chromatography V7.1 Yes Yes

Aspen Custom Modeler V7.1 Yes Yes

Aspen Flare System Analyzer V7.1 Yes No

Aspen HTFS V7.1

Aspen MUSE V7.1

Yes Yes






Aspen Shell & Tube Mechanical V7.1

Aspen Hetran V7.1

Aspen HTFS Research Network V7.1

Aspen Aerotran V7.1

Yes Yes

Aspen Energy Analyzer V7.1 Yes No

Aspen HYSYS V7.1 Yes Yes

Aspen HYSYS Upstream V7.1 Yes Yes

Aspen Economic Evaluation V7.1 Yes No

Aspen Model Runner V7.1 Yes No

Aspen OnLine V7.1 Yes Yes

Aspen Online Deployment V7.1

Note: If HYSYS, Aspen Plus, or ACM are installed in order to support Aspen Online Deployment, then those products MUST be installed with the Standard option or all the required features will not be installed.

Yes Yes

Aspen OTS Framework Yes No

Aspen Plus V7.1 Yes Yes

Aspen Plus CatCracker V7.1 Yes No

Aspen Plus Dynamics V7.1 Yes Yes


Aspen Product Installation Options

Standard Server

Aspen Plus Hydrocracker V7.1 Yes No

Aspen Plus Hydrotreater V7.1 Yes No

Aspen Plus Reformer V7.1 Yes No

Aspen Polymers V7.1 Yes Yes

Aspen Process Engineering Console V7.1 Yes No

Aspen Process Development Console V7.1 Yes No

Aspen Process Manual V7.1 No Yes

Aspen Process Tools V7.1 Yes No

Aspen Properties V7.1 Yes Yes

Aspen HYSYS Refining V7.1 Yes No

Aspen Reaction Modeler Yes No

Aspen Remote Simulation Service V7.1 Yes Yes

Aspen Simulation Workbook V7.1 Yes Yes

Aspen Utilities Planner V7.1 Yes No

Aspen Basic Engineering V7.1 Yes Yes

Note: Aspen Basic Engineering is normally installed in a client-server configuration for project deployment.

Standard Installation This section explains how to install Aspen Engineering products for the first time by using the Standard installation option. The Standard option installs Aspen product components on a single computer.

Note: If this is NOT your first time using the Standard installation, or if you are upgrading an Aspen product, see "6 Adding and Upgrading Aspen Products."

Before You Begin See the “Pre-installation Checklist” section before you begin the installation.

If you are installing any of these products, review the installation notes in their product sections in addition to the installation procedures in this section.

If you are installing

see


Aspen Basic Engineering Installation Notes

Aspen Batch Process Developer

Aspen Batch Process Developer Installation Notes

Aspen Economic Evaluation

Aspen Economic Evaluation Installation Notes

Aspen OnLine Aspen OnLine Installation Notes


Aspen Online Deployment

Aspen Online Deployment Installation Notes

Aspen Plus Aspen Plus Installation Notes

Aspen Properties Aspen Plus Installation Notes

Aspen Remote Simulation Service

Aspen Remote Simulation Service Installation Notes

Standard Installation Using the Aspen Engineering DVD

To perform a Standard installation of Aspen Engineering products

1 Log on to the computer, using an account with Local Administrator privileges.

2 Insert the Aspen Engineering DVD (DVD 1) into the DVD drive.

Note: If the installation does not start automatically, click Start | Run. In the Run dialog box, enter <drive>:\setup (where <drive> is the drive letter assigned to your DVD drive); then click OK.

The AspenTech DVD Browser window appears.

3 Click the Products tab.

Note: If you want to see only products that you are licensed to install, select the Show Licensed Products Only check box.


A license requirement dialog box appears.

4 Click OK.

The License Configuration Wizard appears.

Note: If you are installing the SLM Server, see Software License Manager (SLM) Installation and Reference Guide, which is contained on the Documentation DVD.

5 Click Next.


The License Configuration Type dialog box appears.

6 Accept the default Both option and click Next.

Note: You can click None. If you click None, skip to Step 8 below.

The License Files dialog box appears..

7 Do the following:

o If you have one or more standalone license files that are local to your computer, click Add License File, and then use the Open dialog box to locate the license files (*.lic, *.slf). Then click Next. -and/or-

o If you have licenses that are obtained from a network license server, click Next.


The License Servers dialog box appears.

8 In the License Servers dialog box, enter the License Server name and

click Add Server, and repeat until all applicable License Server names are included in the list. Then click Next.

The Determining Product Licenses dialog box appears.

9 After the Licenses list is populated with all licenses found, click Next. 10 Click Products | Aspen Engineering; then click Install.

The Windows Installer view appears briefly as it prepares for installation. One of the following AspenTech Installer dialogs appears.

This version of the Aspen Installer dialog appears when no aspenONE products are installed:


This version appears when one or more aspenONE products are installed:

11 Whichever screen appears, click Next to continue.


The License Agreement dialog box appears.

12 Click Yes, I accept the terms in the license agreement; then click

Next.

Note: If you have already installed one or more aspenONE products, the next screen will be the Program Maintenance screen.


If you want to install additional programs or remove some (but not all) existing Aspen programs:

o Click Modify; then click Next. Skip to Step 9 below.

The Computer Configuration Type dialog box appears.

13 Click Standard Install to install the Aspen software on a single

computer.

The Choose Destination Location dialog box appears.


14 To specify a different folder, click Browse, then navigate to the correct folder. When you are satisfied with the installation folder (default or your choice), click Next.

The Feature Selection dialog box appears.

15 On the Feature Selection dialog box, click the Aspen product(s) you

want to install on the computer by clicking on the tree of products and product features. Click the PLUS SIGN and MINUS SIGN symbols to display or hide branches of the tree. For each feature, you can select options that control the installation.

Initially, the icons appear with the red “x”. Open a tree and the icon there will also have a red “x”. When you click on the subfeature “x” icon, the following menu appears:

16 On this menu, select how you want that program to be installed.

Note: For an explanation of the icons, click Help.

Changing Product/Subfeature Folders For a selected product, you can change the default destination location of its product directory. You can also change the default destination location of product subfeatures.


To change the destination location of a selected Aspen product or subfeature

A On the Feature Selection dialog box, click Change.

The Change Current Destination Location dialog box appears.

The default destination is:

C:\Program Files\AspenTech

B On the Change Current Destination Location dialog box, either

o browse to the directory that you want to specify as the root destination directory under which all AspenTech products for this software version will be installed on this computer. (If a dialog box appears prompting you for permission to create the folder, click Yes.).

-or- o in the Folder name field, type the path to the directory that

you want to specify as the root destination directory under which all AspenTech products for this software version will be installed on this computer. (If a dialog box appears prompting you for permission to create the folder, click Yes.).

Note: Once the installation of any Aspen product has been completed for this software version on this computer, you cannot change the location of the AspenTech folder.

Note the following product restrictions:

Product Restriction



The Aspen Economic Evaluation product directory must be installed no deeper than the third level of the directory structure. For example: D:\Program Files\AspenTech\Aspen Economic Evaluation V7.1

C Click OK.

You are returned to the Feature Selection dialog box.

17 Click Next to continue.

Configuring Aspen Products at Install Time Depending on the products you are installing, additional dialog boxes may appear, prompting you for product-specific information.

If you are installing you are prompted for

Aspen Basic Engineering If the Aspen Basic Engineering Broker window appears, see Aspen Basic Engineering Installation Notes."

Aspen OnLine DCOM user account, and CIM-IO core security settings. For details, see "Aspen OnLine."

If you install Aspen Remote Simulation Service, or if you install the Aspen Properties Enterprise Database feature of any product when MS SQL Server 2005 or 2008 or MS SQL Server Express 2005 is not already installed on the computer, you are prompted for the username and password of an account which will be used to run these services.

When you install the Aspen Properties Enterprise Database feature of any product and MS SQL Server 2005 or 2008 or MS SQL Server Express 2005 is


already installed on the computer, it will be used. If more than one such SQL server instance is installed, the installer will ask which one to use.

If you are installing Aspen Plus or Aspen Properties, you will be prompted to configure the Fortran compiler. If no Fortran compiler is installed, the dialog box will appear as shown below with the choices set to User and dimmed. If one or more compilers are installed, you will be able to choose the Fortran compiler to use.


Ready to Install 18 Click Next until the Ready to Install the Program dialog box appears.


19 Review your selected installation options. (To modify any selected option, click Back to navigate to the appropriate dialog box and make the changes.)

20 To complete the installation, click Install. 21 Wait as the installation begins. The Installing Aspen Engineering

screen appears on which you can monitor the progress of the installation.

Setup Complete Once the installation is finished, the Wizard Completed dialog box appears.

22 Click Finish.

23 A message box appears asking you to restart your computer. Do either of the following:

o Click Yes to restart your computer right away. The system shuts down and reboots.

o Click No to restart it later.

24 When the system reboot is complete, log on to Windows using an account with local Administrator privileges.


Client-Server Installation

Overview This section provides instructions for installing Aspen products in a client-server installation configuration.

Note: Only system administrators should perform this type of installation.

A server installation of Aspen products takes advantage of using a powerful server computer to perform calculations and various data- processing activities. The following Aspen products support the Server installation option:

• Aspen Adsorption V7.1

• Aspen Basic Engineering V7.1

• Aspen Chromatography V7.1

• Aspen Custom Modeler V7.1

• Aspen Distillation Synthesis feature in Aspen Plus V7.1

• Aspen Exchanger Design and Rating V7.1

• Aspen HTFS V7.1

• Aspen HYSYS V7.1

• Aspen HYSYS for Upstream V7.1

• Aspen OnLine V7.1

• Aspen Online Deployment V7.1

• Aspen Plus V7.1

• Aspen Plus Dynamics V7.1

• Aspen Polymers V7.1

• Aspen Process Manual V7.1

• Aspen Process Tools V7.1

• Aspen Properties V7.1

• Aspen Remote Simulation Service V7.1

• Aspen Simulation Workbook V7.1

Before You Begin Before you begin the installation process:

• Review the “Pre-installation Checklist" section.

• Because several users may be running a calculation engine on the server simultaneously, ensure the server machine has appropriate resources. For guidelines, see "Checking Aspen System Requirements."

• Ensure the server and client machines use TCP/IP communication and have the appropriate network access in both directions.

• Ensure the server and the user PCs have the proper name resolution present so that the user PCs recognize the server name entered at run time.


• Ensure that the users of Aspen products have Windows accounts that are valid on the application server.

• If you are installing any of these products, review the installation notes in the appropriate product section, in addition to the installation procedures in this section.

If you are installing

see


Aspen Basic Engineering Installation Notes


Aspen Economic Evaluation Installation Notes

Aspen OnLine Aspen OnLine Installation Notes

Aspen Online Deployment

Aspen Online Deployment Installation Notes

Aspen Plus Aspen Plus Installation Notes

Aspen Polymers Aspen Polymers Installation Notes

Aspen Process Manual

Aspen Process Manual Installation Notes

Aspen Properties Aspen Properties Installation Notes

Client-Server Installation Using the Aspen Engineering DVD The following summarizes the steps for installing Aspen products for a client-server network configuration.

1 On the server machine, perform a Server installation of Aspen products.

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

3 On each user PC, perform a Standard installation of Aspen products.

4 Configure the user PCs to use the remote server.

5 Verify communications between the server and the user PCs.


Installing Aspen Software on a Server

Note: You must install any of the following products on the same server machine and specify the same working folder as Aspen Plus:

• Aspen Adsorption

• Aspen Chromatography

• Aspen Custom Modeler

• Aspen Plus Dynamics

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


Installing the Software

To Install Aspen server software on the server machine:








4 Click OK.




5 Click Next. The License Configuration Type dialog box appears.





7 Do the following:

o If you have one or more standalone license files that are local to your computer, click Add License File, and then use the Open dialog box to locate the license files (*.lic, *.slf). Then click Next.

-and/or- o If you have licenses that are obtained from a network license server,

click Next. The License Servers dialog box appears.





9 After the Licenses list is populated with all licenses found, click Next.

10 Click Products | Aspen Engineering; then click Install.


This version of the Aspen Installer dialog appears when no aspenONE products are installed:

This version appears when one or more aspenONE products are installed:


11 Whichever screen appears, click Next to continue.

Note: If you have already installed one or more aspenONE products, the next screen will be the Program Maintenance screen.


If you want to install additional programs or remove some (but not all) existing Aspen programs:

o Click Modify; then click Next. Skip to Step 9 below.


12 Click Server Install to install the Aspen software on a single computer.

The Aspen Engineering V7.1 Setup dialog box appears.

13 Click Next.


The License Agreement dialog box appears.

14 Click Yes, I accept the terms in the license agreement; then click

Next.


15 To specify a different folder, click Browse, then navigate to the correct folder.

When you are satisfied with the installation folder (default or your choice), click Next.



16 On the Feature Selection dialog box, click the Aspen product(s) you

want to install on the computer by clicking on the tree of products and product features. Click the PLUS SIGN and MINUS SIGN symbols to display or hide branches of the tree. For each feature, you can select options that control the installation.

Initially, the icons appear with the red “x”. Open a tree and the icon there will also have a red “x”. When you click on the subfeature “x” icon, the following menu appears:

17 On this menu, select how you want that program to be installed.

Note: For an explanation of the icons, click Help.

Changing Product/Subfeature Folders For a selected product, you can change the default destination location of its product directory. You can also change the default destination location of product subfeatures.


To change the destination location of a selected Aspen product or subfeature

A On the Feature Selection dialog box, click Change.

The Change Current Destination Location dialog box appears.

The default destination is:

C:\Program Files\AspenTech

B On the Change Current Destination Location dialog box, either

o browse to the directory that you want to specify as the root destination directory under which all AspenTech products for this software version will be installed on this computer. (If a dialog box appears prompting you for permission to create the folder, click Yes.).

-or- o in the Folder name field, type the path to the directory that

you want to specify as the root destination directory under which all AspenTech products for this software version will be installed on this computer. (If a dialog box appears prompting you for permission to create the folder, click Yes.).

Note: Once the installation of any Aspen product has been completed for this software version on this computer, you cannot change the location of the AspenTech folder.

Note the following product restrictions:

Product Restriction



The Aspen Economic Evaluation product directory must be installed no deeper than the third level of the directory structure. For example: D:\Program Files\AspenTech\Aspen Economic Evaluation V7.1

C Click OK.

You are returned to the Feature Selection dialog box.


Configuring Aspen Products at Install Time Depending on the products you are installing, additional dialog boxes may appear, prompting you for product-specific information.

If you are installing you are prompted for

Aspen Basic Engineering If the Aspen Basic Engineering Broker window appears, see Aspen Basic Engineering Installation Notes."

Aspen OnLine If the User name and Password window appears, see "Aspen OnLine."

If you install Aspen Remote Simulation Service, or if you install the Aspen Properties Enterprise Database feature of any product when MS SQL Server, MS SQL Server Express, or MSDE is not already installed on the computer, you are prompted for the username and password of an account which will be used to run these services.

When you install the Aspen Properties Enterprise Database feature of any product and MS SQL Server, MS SQL Server Express, or MSDE is already


installed on the computer, you are instead prompted for the database admin name and password, and if more than one SQL server instance is installed, which one to use.

If you are installing Aspen Plus or Aspen Properties, after one of the previous two screens you will be prompted to configure the Fortran compiler. If no Fortran compiler is installed, the dialog box will appear as shown below with the choices set to User and dimmed. If one or more compilers are installed, you will be able to choose the Fortran compiler to use.


Ready to Install 18 Click Next until the Ready to Install the Program dialog appears.

19 Review your selected installation options. (To modify any selected option,

click Back to navigate to the appropriate dialog box and make the changes.)


20 To complete the installation, click Install.

21 Wait as the installation begins. The Installing Aspen Engineering screen appears on which you can monitor the progress of the installation.


22 Click Finish.





Installing Aspen Basic Engineering

Note: If you are not installing Aspen Basic Engineering, skip this section.

To install Aspen Basic Engineering: 1 Go to "Client-Server Installation," and follow the procedure outlined until

the Feature Selection window appears.


2 Expand the Aspen Basic Engineering feature and select either all or only those applications you require, from beneath User Services only. Do not select any Data Services components for a Client install.

3 The Aspen Basic Engineering Business Server Host dialog box appears.

4 Specify the default server (Business Server Host) that the client

applications will connect to.


The ProVision dialog box appears prompting you to enter the name of the ProVision configuration file (if ProVision was specified as an install option).

6 If you want to change these default locations, click Browse to navigate to

the file.



8 Return to the Ready to Install section to complete the installation.

For information about changing licensing, see Software License Manager (SLM) Installation and Reference Guide, which is contained on the Documentation DVD.

Configuring a Windows Server as an Aspen Host Note: This does not apply to Aspen Basic Engineering.

After you complete the installation of the Aspen server components on the server machine, you must configure the server as an Aspen host.

Each user connecting to the Windows Server must 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 must also be granted Log on as a Batch Job access to the server.

Adding Windows Server Accounts The following sections provide detailed instructions for configuring user accounts on Windows Server, using sample groups, accounts, and domains.

Creating Local Group and User Accounts

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; then 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, click Users, and on the Action menu, click New User.

The New User dialog box appears.

6 In the New User dialog box, type the following information:


In this field type

Username The name of the new user.

Password The password based on your local security policy. Confirm Password

7 Clear User must change password at next logon and click Password never expires.

8 Click Create; then close the dialog box.

9 Double-click the new user you just created. In its Properties dialog box, click the Member of tab.

10 Click Add.

11 Type the name of the group and click Check Names to verify it is correct. Then click OK.

12 Click OK to close the Properties dialog box.

13 Repeat Steps 4 through 12 to create or add more users to the group.

14 When you finish adding users to the group, close the Computer Management console.

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

Setting User Rights Each user account that connects to the server must be granted Log on 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; 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 Log on as a Batch Job.

5 Click Add User or Group. Click Locations, and select the local computer.

Type the names of accounts to which you want to assign the right, then click Check Names.

6 Click OK; then click OK again.

7 Confirm that the changes have taken effect locally by closing the Local Security Policy window and re-opening it.

The newly assigned rights should appear under the Effective Settings columns.

You can now proceed with the installation on the user PCs.


Installing Aspen Products on User PCs The following table summarizes the steps for installing Aspen products on user PCs in a client-server network configuration.

1 On each user PC, perform a Standard installation of Aspen products.

2 Configure the user PCs to use the remote server.

Configuring Installed Aspen Products on User PCs Before you can run Aspen simulation/calculation software installed on the server machine, you must specify the name of the server the first time you run the product from the user PC.

Specifying a Remote Server The following sections contain detailed instructions on specifying the remote server for Aspen products.

Aspen Properties

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

Modeling V7.1 | Aspen Properties | Aspen Properties User Interface.

2 On the Aspen Properties menu bar, click Tools | Options.

3 On the Options dialog box, click the Remote Server tab.


4 On the Remote server tab, type the following information:

In this field do this

Server Type Select Windows server from the list

Server Name Note: Ensure the accuracy of both case and spelling of the server name. The name is used to resolve the network address of the computer and must be in a form recognizable to your Domain Name Server.

Specify the name of the server running the calculation engine

Username Specify the user name of the user under whom the simulation server software will run on the remote server. You must supply a name.

Working Directory Specify the pathname of the root folder on the remote machine where the run-time data, such as property data (.aprpdf), history, report and other files, will be stored. For example, \My Simulations\UserName

5 Click OK.

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


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

Aspen Plus

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

Modeling V7.1 | Aspen Plus | Aspen Plus User Interface.

Note: The Connect to Engine dialog box may appear automatically.

2 On the Aspen Plus menu bar click Run | Connect to Engine.

The Connect to Engine dialog box appears.

3 Change the Server Type to Windows server.

4 Enter the following user information:

o Node name of the server running the simulation engine

o User name

o User’s Password

o Appropriate Working directory

Note: If you are using domain accounts, the Domain Name must precede the user name. For example, MAGIC\potterh would be a valid login for the MAGIC domain.

5 Click OK to connect to the calculation server.

If everything is configured correctly, the status bar should display Connection Established.


Aspen Modeler Products:

Aspen Adsorption

Aspen Chromatography

Aspen Custom Modeler

Aspen Plus Dynamics

To specify a remote server from a user PC running any of the Aspen Modeler products: 1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | <Aspen product >| <Aspen 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 Type a Current configuration name.

This name can be the name of the computer where the simulation server software will run, or it can be a name with meaning to you only.

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

6 On the Host Properties dialog box, enter the following information:


In this field Do this

Host name

Type the name of the server where the simulation server software is installed.

Note: Ensure the accuracy of both case and spelling of the server name. The name is used to resolve the network address of the computer and must be in a form recognizable to your Domain Name Server.

User name Type the user name for the account on the server computer that you will use to run the server software.

Password Type the password for the account on the server computer that you will use to run the server software.

7 Click OK.

8 In the Servers dialog box, click the name of the server you just added as the Host Computer.

For example:

9 In the Configuration Properties section, specify the following:


Working folder Specify the pathname of the root folder on the remote machine, where run-time data, such as simulation snapshots and plot



data, will be stored. For example, C:\My Documents\AspenTech\Aspen Product Note: Snapshots and plot data will be stored in folders of this working folder on the remote server machine.

Executable folder Type the pathname of the folder where the simulator executables are installed on the remote machine. For example, C:\Program Files\AspenTech\AMSystem V7.1\Bin

Prompt for Password (optional) Select this option if you want the system to prompt for the remote password rather than use the stored one associated with the host.

Visible Console (optional) Select this option if you have your own code linked into the server and want to debug it. This is an advanced option and is not for normal use.

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

11 In the Server Configurations dialog box, click OK.

You are notified that you must restart the Aspen product for the changes you have made to take effect.

After you have restarted the Aspen product, you can run simulations and/ or calculations from your PC on the remote server you specified.

Checking the Status Bar

To quickly verify that an installed product is using the remote configuration you specified

• Look for the configuration name on the status bar, for example:

Verifying Client–Server Communication To verify that the installation on the user PC is successfully communicating with the server running the Aspen simulation and calculation 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 Aspen products, as described in this section.

4 Verify the installation of Aspen products on the user PCs, using verification procedures in the appropriate product tabs.

Aspen Adsorption, Aspen Chromatography, Aspen Custom Modeler, Aspen Plus Dynamics If you encounter any problems running any of these Aspen products, you can ensure that REXEC is working correctly on the user PC.

To ensure that REXEC is working correctly on the user PC:

• At the command prompt on the user PC, type:

rexec MachineName pathname\sim_server.exe Name (DomainName:UserName): UserName Password (DomainName:UserName):

For example, where the:

• Machine name is Blue

• Path is C:\Program Files\AspenTech\AMSystem V7.1\bin\

• Domain is aspen.com

• UserName is Fred

You would type:

rexec Blue C:\Program Files\AspenTech\AMSystem V7.1\bin\sim_server.exe Name(aspen.com:Fred): Fred Password (Blue:Fred): A message similar to the following example indicates a successful verification: sim_server.exe (Version 23.0) built on Nov 5 2008 at 17:40:23

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

Verifying the Installation For most Aspen products, you can verify that the installation succeeded by running the Aspen product you installed. However, some Aspen products have product-specific verification requirements. For verification (and configuration) information, see "Chapter 5 Verifying and Configuring Aspen Products."

Configuring Installed Aspen Products After installation is complete, the following Aspen products require additional configuration.


Aspen Product Notes

Aspen OLI Interface in Aspen Plus

Complete the installation with the OLI Alliance Suite.

Aspen OnLine See "Configuring Aspen OnLine."


Log on as Administrator and configure Aspen Basic Engineering. For instructions, see "Verifying an Aspen Basic Engineering Installation."

4 Individual Product Installation Notes 79

4 Individual Product Installation Notes

Some Aspen Engineering products have product-specific installation notes. Those notes are listed below in alphabetical order.

Installation Notes

Aspen Basic Engineering Installation Notes Important Note: Uninstall any earlier (pre-release) versions of Aspen Basic Engineering or Aspen Zyqad before installing this release of Aspen Basic Engineering V7.1.

Installation Types Aspen Basic Engineering can be installed as either a Standard or a Server installation: Installation Notes

• The Standard install option can be used to install all client and server components onto a single machine. Such an installation lets the machine operate as a server, as well as allowing the user to connect to the local server or other server installations. This can be convenient for administrators and customization users. For details, see "Aspen Basic Engineering Standard Installation Notes."

• A Client only install is done by clicking on the Standard Install button and from selecting only User Services components. For details, see "Aspen Basic Engineering Client Installation Notes."

• The Server only install option will install Data Services. For details, see "Aspen Basic Engineering Server Installation Notes."

Note: Most installations will be either server only or client only.

80 4 Individual Product Installation Notes

Aspen Basic Engineering Standard Installation Notes

To install Basic Engineering:

1 Follow the procedure outlined in "Client-Server Installation," until the Computer Configuration Type dialog box appears.

2 Click Standard Install.


3 Select the feature(s) you wish to install. For details, see "Client-Server Installation."

The Aspen Basic Engineering Broker dialog box appears.

4 On this dialog, your Name must be defined to allow the broker to run as an existing or new user.

Existing User. To access the database as an existing user, enter an existing (valid) username in the Name field (this includes a domain name; for example, MYDOMAIN\AZUSER_YourName) and the correct password in the Password field.

New User. To access the database as a new user, enter your username in the Name field (this includes a domain name; for example, MYDOMAIN\AZUSER_YourName) and your password in the Password field. The install creates this new username on the local machine. You must also assign user privileges.


Important: This password must be valid according to your company password security policy. If you enter a password in this field, please record it for future reference as it may be required if you uninstall, then re-install the application under a previously used broker account.



6 If you wish to change these default locations, click Browse to navigate to the file.


8 Return to the section Ready to Install for instructions on how to complete the installation.

For information about changing licensing, see Software License Manager (SLM) Installation and Reference Guide on the Documentation DVD.

Aspen Basic Engineering Client Installation Notes

To install Aspen Basic Engineering:

1 Follow the procedure outlined in "Client-Server Installation," until the Computer Configuration Type dialog box appears.

2 Click Standard Install.



3 Expand the Aspen Basic Engineering feature; then select either all or only those applications you require, from beneath User Services only. Do not select any Data Services components for a Client install.

4 The Aspen Basic Engineering Business Server Host dialog box appears.

5 In the Host field, type the default server (Business Server Host) that the

client applications will connect to.



7 If you want to change these default locations, click Browse to navigate to the file.



9 Return to the section Ready to Install for instructions on how to complete the installation.

For information about changing licensing, refer to Software License Manager (SLM) Installation and Reference Guide, which is contained on the Documentation DVD.

Aspen Basic Engineering Server Installation Notes The following section summarizes the steps required to install the Aspen Basic Engineering server application on a server host. For a client-server configuration, follow these steps.

1 On the server machine, perform a Server installation.

2 Perform a Client installation on each Client PC.

3 Configure the Client PCs to use the remote server.

4 Verify communications between the Server(s) and Clients (refer also to the Administration help).


Aspen Basic Engineering Server Installation 1 Follow the procedure outlined in "Client-Server Installation" until the

Computer Configuration Type dialog box appears.


2 Click Server Install.

3 Select the feature(s) you wish to install. For details, see "Client-Server Installation."

The Aspen Basic Engineering Broker dialog box appears.

On this dialog, username must be defined to allow the broker to run as a user.

o Existing User. To access the database as an existing user enter an existing (valid) username in the Name field (this should also include a domain name; for example, MYDOMAIN\AZUSER_YourName) and the correct password in the Password field.

o New User. To access the database as a new user enter your username in the Name field (this should also include a domain name; for example, MYDOMAIN\AZUSER_YourName) and your password in the Password field. The install creates this new username on the local machine. You must also assign user privileges.

Important: This password must be valid according to your company security policy. If you enter a password in this field, please record it for future reference as it may be required if you uninstall, then re-install the application under a previously used broker account.


5 Return to the Ready to Install section to complete the installation.


Uninstalling and/or Reinstalling Uninstall any pre-release versions of Aspen Basic Engineering V7.1 before installing Aspen Basic Engineering V7.1.

Note: You do not need to uninstall Aspen Zyqad 2006.5 (or previous versions) before installing Aspen Basic Engineering V7.1.

Disconnecting Users from the Server When you are reinstalling, users/clients need to be disconnected from the Aspen Basic Engineering Server. You can do this in two ways:

• Ask users to disconnect, and then reboot the server machine. Ask the users not to reconnect until the installation is complete.

• Alternatively, you can stop the Aspen Basic Engineering Server in the following way:

1 On the Start menu, click Control Panel | Administrative Tools | Services.

2 Click AZ161Broker. 3 Right-click and select Stop. (You can also prevent the Broker service

from automatically restarting by clicking Properties. On the Properties dialog box, navigate to the General tab; then switch the startup type from Automatic and Manual to prevent it from being restarted.)

4 When the installation operation is complete, ensure the AZ161Broker service startup type is switched back to Automatic.

Aspen HYSYS Installation Notes

Installing OLI Alliance Suite for HEO This software is necessary to use electrolytes in HYSYS. OLI Alliance Suite for HEO is not distributed by AspenTech. Contact OLI Systems to get the software and a license for it. Once installed and configured, HYSYS will automatically detect its presence and the Electrolytes feature within HYSYS will be enabled

Aspen OnLine Installation Notes Aspen OnLine consists of:

• Aspen OnLine Server, which communicates with CIM-IO to retrieve plant data and with simulators – for example, Aspen Plus, Aspen Custom Modeler, or Aspen Utilities Planner – 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 the computer where Aspen Online Server is installed.

Aspen Online Deployment Installation Notes • If you plan to use versions of Aspen Custom Modeler, Aspen Plus, HTFS+,

or HYSYS that are earlier than aspenONE V7.1, install them prior to installing any software from the aspenONE V7.1 suites.

• The required software from the Aspen Manufacturing Suite V7.1 can be installed either before or after the software from the Aspen Engineering V7.1.

• A recommended implementation architecture, for a production environment, is to use at least four different computers: one for the engineering workstation (to build and maintain the process models and online applications, one for the Aspen Online Deployment online application server, one running Aspen Remote Simulation Service, and one running the Aspen PCWS Server. If you are using Aspen Local Security, then this would typically be installed on the same machine as the Aspen PCWS Server. The necessary simulators (Aspen Custom Modeler, Aspen Plus, HYSYS) would be installed on both the engineering workstation and on the remote simulation server.

• If you use the Aspen Remote Simulation Server, change the service properties of the Aspen Remote Simulation Server service to log on as the Local System account and to interact with the desktop.


Aspen Online Deployment post installation notes: Desktop • No post-install configuration is required.

• In order for the product to be useful, you should have one or more of the supported versions of HYSYS, Aspen Plus, HTFS+, or Aspen Custom Modeler installed on the desktop.

• When you first use the Aspen Online Deployment Desktop to connect to an Online Deployment application server (using the Online | Servers menu), you may get a Windows Security Alert dialog box that informs you that "Windows Firewall has blocked some features of this program": Online Deployment Desktop. If you get this message, then click the Unblock button on the dialog.


Aspen Online Deployment post installation notes: Server

Note: Some of these items require the use of the server configuration dialog. That dialog is invoked from the Aspen Online Deployment Desktop, running on the online application server computer, using the menu item Online | Configure This Server. • Install Aspen CIM-IO, Process Data, and ADSA (Aspen Data Source

Architecture) from the Aspen Manufacturing Suite (DVD 2). This can be done before or after installing Online Deployment. The ADSA install is not required if you use the ADSA Client Config Tool (installed by Process Data) to reference an ADSA public directory server on another computer system.

• Install a PCWS web server. This is best installed on a separate computer from the Aspen Online Deployment server. This can be done before or after installing Aspen Online Deployment. See the Aspen Manufacturing Suite Advanced Process Control Installation Guide for installation procedures.

• Select or change your security server, if needed.

1 Log on using the account name and password of an account in the Administrators group of the computer where the software is installed.

2 Click Start | Programs | AspenTech | AFW Tools. The AFW Tools dialog box is displayed.

3 Select the Client Registry Entries tab.

4 In the Name column, double-click URL. The URL defines the location of the security server’s interface, pfwauthz.asp. The Update Registry dialog box is displayed.

5 In the Data field, enter the security server location information. For example, http://hostname/aspentech/afw/security/pfwauthz.asp, where hostname is the name of the computer where the security server is installed.

• Configure CIM-IO servers as needed. The procedure for doing this manually is described in the Aspen Manufacturing Suite Advanced Process Control Installation Guide. You can also use the Aspen Online Deployment Desktop’s server configuration dialog. See the Aspen Online Deployment Desktop help or details.

• Use the ADSA Client Config Tool to establish public data sources for any historians or data servers as needed.

• Use the Online Deployment Desktop’s server configuration dialog to configure authorization to control access to the online applications. See the Desktop’s online help for details.

• Use the Online Deployment Desktop’s server configuration dialog to specify I/O Servers corresponding to the CIM-IO, OPC, and Process Data sources of interest.

• Enable the RTE service by selecting the Enable Server check box in the server configuration dialog.

• If you use the Aspen Remote Simulation Server, change the service properties of the Aspen Remote Simulation Server service to logon as the Local System account and to interact with the desktop. This will ensure


that the maximum possible Windows resources are available to the process simulators.

Aspen Plus Installation Notes

Installation Details for Aspen Plus and Aspen Properties

Installing the Aspen Properties Enterprise Database The AspenTech Installer looks for an existing SQL Server (2005, 2008, or SQL Express 2005) installed on your computer. If it does not find one, it automatically installs MS SQL Express 2005. See the Troubleshooting section for issues related to installing SQL Express.

Note: Due to problems encountered with MSDE and MS SQL Server 2000, Aspen Properties Enterprise Database no longer uses these SQL Servers, and will install MS SQL Express 2005 if no other SQL Server is found.

If multiple SQL Servers of these versions are found, the installer will ask which one to use:


Note: The server must be configured to SQL Server and Windows authentication mode before you can use it with Aspen Plus. See "Configuring Microsoft SQL Server or SQL Express."

At some sites, policy may prohibit the installation of SQL Server on individual computers. In this case, the legacy databanks may be used or Aspen Plus may be configured to use SQL Server on a designated computer. To install Aspen Plus without installing a SQL Server:

1 Create the following registry entry:

[HKEY_LOCAL_MACHINE\SOFTWARE\AspenTech\Setup] "NOSQLExpress"=dword:00000001

2 Install Aspen Plus as usual.

Aspen OLI Interface Installation Notes

Note: The Aspen OLI Interface is a subcomponent of the Aspen Plus and Aspen Properties installations, not Aspen OLI.

Aspen OLI Interface V7.1 consists of two parts: • Aspen OLI Interface provided by Aspen Technology, Inc.

• OLI Alliance Suite for Aspen OLI Interface V7.1 provided by OLI Systems, Inc.

The installation procedure for Aspen OLI Interface is the same as with any other Aspen products. But the OLI Alliance Suite for Aspen OLI Interface V7.1 is installed from a standalone setup program provided by OLI Systems.

The installation of Aspen OLI Interface V7.1 requires three steps:

1 Install the Aspen OLI Interface, a subfeature of Aspen OLI Interface V7.1 through the Aspen Installation. When this installation is complete, all of the components required within the Aspen framework to support the OLI Engine are ready.

Note: To install Aspen OLI, follow the procedure outlined in "Client-Server Installation," before proceeding with the Installing Alliance Suite for Aspen OLI step.

2 Obtain the OLI HardLock security key and serial number to enable OLI’s security system. This procedure is outlined in the "OLI HardLock Security Key" section below.

3 To complete the installation of Aspen OLI install OLI Alliance Suite for Aspen OLI V7.1. This procedure is outlined in the "Installing Alliance Suite for Aspen OLI" section below.

Installing Alliance Suite for Aspen OLI

Overview The Alliance Suite for Aspen OLI Interface V7.1 is a collection of utilities that help you prepare Aspen Plus simulation models using OLI aqueous electrolytes physical properties and equilibrium calculations.


OLI HardLock Security Key You must have an OLI HardLock security key and serial number to enable OLI’s license manager. Existing customers will automatically get the OLI HardLock security key and serial number as part of the continued licensing of Aspen OLI. If you do not have the key or serial number, contact OLI Systems (973-539-4996).

If you are installing the Alliance Suite for Aspen OLI Interface 2006 from the aspenONE DVD set, or if you downloaded the self-extracting executable from the OLI Systems website, then you must contact OLI (973-539-4996) to obtain a HardLock key and associated serial number.

Installing the HardLock Security Key

To install the HardLock security key

• Attach the key to the parallel port located on the back of your computer.

o If you have the USB version of the HardLock key, attach it to any available USB connection.

o If you have a parallel port version of the HardLock key, and you have a printer connected to the parallel port, unplug your printer. Connect the key, and then reconnect your printer to the HardLock key. The HardLock key does not interfere with your printer.

Note: If you have a parallel port security key for another software product, please make sure that the OLI HardLock key is connected directly to the parallel port and is first in the chain of keys.

OLI Alliance Suite The Alliance Suite uses InstallShield to lead you through a typical Windows installation process. To complete the installation of Aspen OLI, you must install the OLI Alliance Suite. This installation is available in two formats:

• A self-extracting executable file named OLI Alliance Suite for Aspen OLI V7.1.exe that is distributed on the Aspen DVD set and the OLI Systems website.

• A product distribution DVD from OLI Systems.

Components OLI Alliance Suite for Aspen OLI V7.1.1.0.1.exe will install the following components:

• Chemistry Wizard. Used to prepare OLI chemistry model files and Aspen Plus .bkp files.

• Data Locator. A utility for searching species in the OLI component databanks.


• Chemistry Generator. The original utility for creating OLI chemistry model files and the Aspen Plus .bkp files. The Chemistry Wizard has replaced this utility.

• OLI security system for the OLI Property and Equilibrium Calculation Engine.

Installing If you are installing the file OLI Alliance Suite for Aspen OLI V7.1.1.0.1.exe from the aspenONE DVD set, you will find the self-extracting executable on DVD 1. Go to Step 1 below.

Note: You can also download the .exe. If you already downloaded the self-extracting executable from the OLI Systems website, then go to Step 1 below. If you did not download the file yet, go to this site: http://www.olisystems.com/olidownload.htm Note: The .exe is also on the product DVD from OLI. If you have a product distribution DVD provided by OLI, then insert the DVD and run X:\setup.exe (where X: is the drive letter for your DVD). Or, open Windows Explorer, locate setup.exe and double-click on it. Go to Step 2 below.

1 Open Windows Explorer, and double-click on this self-extracting file to install the components in a directory that you can specify, or in the default location (C:\Program Files\OLI Systems\Alliance Suites\Aspen OLI V7.1).

2 On the Welcome screen, click Next. 3 On the License Agreement screen, click Yes to accept the agreement.

The Customer Information screen appears.

http://www.olisystems.com/olidownload.htm


4 Type your name and company name. To complete the Serial Number field, you need the serial number provided by OLI Systems. Click Next to continue.


5 If possible, leave the default location. If you need to change it, click on

the Browse button and specify a new path. Click Next to continue.

6 On the Setup Type screen, select Custom. The default selection of Custom is useful since you can see which features will be installed.

7 Click Next. The Select Components dialog box appears as shown.


Note: The HardLock Security Files component will be visible and selected if you have an OLI HardLock key and serial number from OLI. The default setting is to install all of the features of the Alliance Suite for Aspen OLI (highly recommended). If you are an experienced OLI user and you know that you do not want to use one or more of the optional databanks, then you can clear them to save disk space.


9 On the Select Program Folder screen, the default program folder is set as a folder within the Aspen program folder hierarchy. If you prefer to place it in another folder, type in the new location.

10 Click Next.

The installation begins.

HardLock Device Driver Installation Script After the files are copied and the program group is populated, the HardLock device driver installation script starts. This is a very brief installation, and you are not prompted for any information.


1 Read the screen and close any other programs if needed.

2 Click Next to complete the installation. After the HardLock drivers are installed, the InstallShield Wizard Complete screen appears.

3 Click Finish to exit the installation.

Aspen Process Manual Installation Notes

Server Configuration Notes: • Although you may be able to install the Process Manual on non-server

operating systems, these support a limited number of connections, so only a few users will be able to access this system simultaneously.

• Security restrictions in service packs to Internet Explorer require the domain name (typically the same as the machine name) to only include alphanumeric, “.” and “-” characters. In particular, the underscore character is not permitted. If the domain name has other characters, then cookies are not stored correctly and the Process Manual application will not operate correctly.

Windows 2003 • Make sure that the correct Windows components are installed; in

particular IIS and Active Server Pages (ASP), which are not installed by default.

o Start the Add/Remove Windows Components dialog.

o Ensure that under Internet Information Services that the Internet Information Services Snap-In and World Wide Web Server are installed.


Windows 2008 • Make sure that the correct Windows components are installed; in

particular IIS and Active Server Pages (ASP), which are not installed by default. Using the Server Manager, ensure that the following are installed:

o Roles:

Web Server (IIS).

o Role services:

Web Server | Application development | ASP

Management Tools | IIS 6 Management Compatibility.

Application Configuration During installation, the Process Manual application will be configured on the URL:

http://server/AspenTech/ProMan

This will be associated with the web sub-folder in the Process Manual installation.

• For improved performance, we recommend running the SLM Configuration Wizard, selecting the Advanced settings and optimizing the licensing type. This will reduce the server time when checking licenses. Refer to the SLM documentation for further details.

To complete the installation, the system must be configured and the new documents registered.

• To start this process, select the shortcut

o Start | Program Files | AspenTech | Aspen Engineering | Aspen Process Manual V7.1 | Process Manual Administration

• This will display an administration page where some of the configuration options can be set.

Note: If the administration page fails to appear, with an HTTP Error 404 message, check that you have configured IIS for Active Server Pages (ASP). Also note that this is a different setting from ASP.NET.

• Contact configuration

o Scroll down the page to the Intranet application settings section.

o You should enter some appropriate settings for the contact details, and click on the Update contact settings button.

o The Performance and configuration section usually be left at the default values.

• Document registration

o Scroll to the Document server settings section.

o The search path indicates where the documents are stored on the server; this should have been configured correctly during installation.


o However, you need to re-index the documents to make them available to the system, and to end users. To do this, click on the Re-index documents button.

o You should see a list of documents appearing on the screen. Indexing usually takes up to a minute.

o When it is complete, click on the Return to administration page button. To confirm that the process has worked, check that the Technical area menu at the top left now has contents.

• Before using the web server, please ensure that you have configured the Software License Manager (SLM). We recommend specifying a named license server to improve performance. Refer to the SLM documentation for details on how to do this.

The system is now installed and ready for use.

Aspen Simulation Workbook Installation Notes Aspen Simulation Workbook V7.1 is compatible with Aspen Plus V7.1, Aspen HYSYS V7.1, and the various Aspen Modeler V7.1 products (ACM, Aspen Plus Dynamics, and so on.).

Version Coexistence Any two versions of Aspen Simulation Workbook (and Aspen OSE Workbook) cannot coexist within the same Excel Application. It is recommended that previous versions of Aspen Simulation Workbook or Aspen OSE Workbook are uninstalled prior to installing the current version.

It is possible to use both versions on the same machine but only one may be enabled within Excel at any given time. The version that will be run by default when Excel starts and can be selected using the Aspen Simulation Workbook Add-In Manager, which is available from the AspenTech | Aspen Engineering | Aspen Simulation Workbook V7.1 Start menu.


Disabling Add-in by Default Aspen Simulation Workbook can be installed so that it is effectively disabled for any user of Excel on the machine. Technically, the Excel Add-In will start once for each user on the machine and disable itself prior to it being fully loaded.

To disable Aspen Simulation Workbook by default:

1 Create a registry key HKEY_LOCAL_MACHINE\Software\AspenTech\Aspen Simulation Workbook\V7.1.

2 Create a DWORD value DefaultLoadBehavior and set it to 2.

Users who wish to have Aspen Simulation Workbook enabled will need to run the Aspen Simulation Workbook Add-In Manager, which is available from the AspenTech | Aspen Engineering | Aspen Simulation Workbook V7.1 Start menu, and enable Aspen Simulation Workbook V7.1 on that dialog.

Aspen Utilities Planner Installation Notes Aspen Utilities On-Line Optimizer Installation Notes Aspen Utilities On-Line Optimizer is a solution that consists of Aspen Utilities Planner, Aspen Online, and CIMIO. The Aspen Utilities Planner and Aspen Online installation, configuration, and verification are outlined in this document. Please refer to the Aspen Manufacturing Suite DVD for CIMIO documentation.

Computer Configuration (Installation) Type A Standard Install should normally be selected for Aspen Utilities Planner. The Server Install does not contain all of the required Aspen Utilities Planner features.

Microsoft Excel Interface Setup

To set up the Microsoft Excel interface to Aspen Utilities: 1 Start Microsoft Excel 2003 or 2007.

2 For Excel 2003:

a On the menu bar, click Tools | Add-Ins.

b On the Add-Ins dialog box, click Browse and navigate to the Aspen Utilities Planner bin folder.

The default location is:


C:\Program Files\AspenTech\Aspen Utilities Planner V7.1\bin

c Click Utilities220.xla; then click OK. In the Add-Ins dialog box, click OK.

d When the confirmation dialog box appears, click OK.

3 For Excel 2007:

a Click the Office Button and then click Excel Options at the bottom

b On the left menu, click Add-Ins.

C In Manage: at the bottom select Excel Add-ins and click the Go button.

c On the Add-Ins dialog box, click Browse and navigate to the Aspen Utilities Planner bin folder.


C:\Program Files\AspenTech\Aspen Utilities Planner V7.1\bin

c Click Utilities210.xla; then click OK. In the Add-Ins dialog box, click OK.

An Aspen Utilities item appears on the Add-Ins tab.

100 5 Verifying and Configuring Aspen Products

5 Verifying and Configuring Aspen Products

Overview Generally speaking, to verify that the installation succeeded, you run the product you installed. However, some Aspen products have product-specific verification procedures you should follow to verify that the application installed correctly. In addition, some products have product-specific configuration requirements that must be met before the product can be run.

The following table lists all aspenONE Aspen Engineering products, showing whether they have product-specific verification or configuration procedures.

If the product does not have a product-specific verification procedure, simply run the product to verify that it installed correctly.

Product Special Verification

Special Configuration

Aspen Adsorption V7.1 Yes No

Aspen Basic Engineering V7.1 Yes Yes

Aspen Batch Process Developer V7.1

No No

Aspen Batch Distillation V7.1 Yes No

Aspen Chromatography V7.1 Yes No

Aspen Custom Modeler V7.1 Yes No

Aspen Distillation Synthesis feature in Aspen Plus V7.1

Yes No

Aspen Economic Evaluation V7.1 No No

Aspen Energy Analyzer V7.1 No No




Yes Yes

5 Verifying and Configuring Aspen Products 101

Product Special Verification

Special Configuration



Aspen Hetran V7.1

Aspen HTFS Research

Network V7.1

Aspen Aerotran V7.1

Aspen Shell & Tube

Mechanical V7.1

Aspen Flare System Analyzer V7.1 No No

Aspen HTFS V7.1

Aspen MUSE V7.1

Yes No

Aspen HYSYS V7.1 No No

Aspen HYSYS Upstream V7.1 No No

Aspen Model Runner V7.1 No No

Aspen Online V7.1 No Yes

Aspen Online Deployment V7.1 No No

Aspen Plus V7.1 Yes Yes

Aspen Plus Dynamics V7.1 Yes No

Aspen Plus CatCracker V7.1 No Yes

Aspen Plus Hydrocracker V7.1 No Yes

Aspen Plus Hydrotreater V7.1 No Yes

Aspen Plus Reformer V7.1 No Yes

Aspen Polymers V7.1 Yes No

Aspen Process Manual V7.1 No No

Aspen Process Tools V7.1 No No

Aspen Properties V7.1 Yes Yes

Aspen HYSYS Refining V7.1 No No

Aspen Reaction Modeler V7.1 No No

Aspen Solubility Modeler V7.1 No Yes

Aspen Adsorption This section contains the following: • Verifying an Aspen Adsorption Installation

• Verifying an Aspen Adsorption Installation that uses Aspen Properties

Verifying an Aspen Adsorption Installation

Note: If you have not already done so, restart Windows to activate the changes made to your configuration during the installation.


To verify the installation of Aspen Adsorption on a user PC

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Adsorption | Aspen Adsorption.

2 On the menu bar, click File | Demonstrations.

The Demonstration Organizer window opens.

3 In the top window, click Nitrogen production (single bed approach); then click Open.

A dialog box appears, indicating where the demonstration will be copied to before automatically opening.

4 Click OK.

5 In the top pane of the Exploring – Simulation window, click Flowsheet. 6 In the lower pane, double-click Product_Comp.

A plot opens.

7 On the menu bar, click Run | Run.

After a few moments the dynamic run completes.

8 On the Run complete dialog box, click OK.

The plot should display a result.

9 On the menu bar, click Tools | Report | Global Balances.

Additional messages should appear in the Simulation Messages window.

10 On the menu bar click File | Exit. 11 When prompted to save changes, click No.

Aspen Adsorption closes.


You have successfully verified your installation. You can delete the test folder.

Verifying an Aspen Adsorption Installation that Uses Aspen Properties


To verify an Aspen Adsorption installation that uses Aspen Properties 1 On the desktop, click Start | Programs | AspenTech | Process

Modeling V7.1 | Aspen Adsorption | Aspen Adsorption.

2 On menu bar, click File | Demonstrations.


3 In the top window, click Nitrogen production (single bed approach); then click Open.


4 Click OK.

5 In the top pane of the Exploring – Simulation window, right click Component Lists; then, on the shortcut menu, click Properties.


6 On the Component Properties Configuration dialog box, click Use Aspen Properties. Then click Use Properties definition file.

The Select Properties Definition File dialog box appears.

7 Click Browse to locate the Definition file, N2PSA.appdf; then click OK.

8 Click OK to exit the Physical Properties Configuration dialog box.

9 In the top pane of the Exploring – Simulation window, click Component Lists.

10 In the lower pane, right-click on the item labeled Default. Click Convert; then, in the Convert dialog box, click Yes.

The component list is converted for use with Aspen Properties.

11 Double click the component list Default. 12 In the dialog box that appears, ensure the two components, Nitrogen

and Oxygen, are present in the right-hand list. Then click Cancel. 13 To reconfigure the flowsheet for use with Aspen Properties, double click

any block on the flowsheet (for example F1).

14 In the top pane of the Exploring – Simulation window, click flowsheet.

15 In the lower pane, double-click Product_Comp.

A plot opens.





18 On the menu bar, click Tools | Report | Global Balance.

Additional messages should appear in the simulation message window.

19 On the menu bar click File | Exit. When prompted to save changes, click No.


You have successfully verified your installation with Aspen Properties. You can delete the test folder.

Aspen Basic Engineering This section contains the following sections:

• Verifying an Aspen Basic Engineering Installation.

• Configuring Aspen Basic Engineering after Installation.

Verifying an Aspen Basic Engineering Installation These verification procedure has two parts: • Part One - Verifying Client-Server operation:

Proceeds to check client-server connectivity. This procedure assumes you have Microsoft Access installed on your server host machine and are performing a Server install.


• Part Two - Verifying component installation: Necessary to perform basic component installation checks without checking client-server operation.

Verifying Client-Server Operation This procedure checks client-server connectivity. Exit each component before moving to the next step.

At this stage, establishing client/server connectivity is sufficient to verify successful installation. It is not necessary to modify existing diagrams or datasheets.

Note: Before starting this procedure, ensure you have a valid username and password (or obtain one from your System Administrator); this allows you to log on to the Workspace(s) you wish to connect to.

Logging On and Setting Up User Privileges 1 Log on to your PC with Administrator privileges and start the Computer

Management control panel.

2 Under Services Check that the AZ161Broker service is present and running. If it is not running, check the Properties/LogOn settings to ensure the selected account exists and the password is correct.

3 Under Users and Groups Ensure that everyone who is going to create workspaces is a member of the Zyqad Administrators group.

4 Run the Aspen Basic Engineering Administration tool and check the local privileges adding additional users and roles as required.

Connecting to a Workspace

5 On the desktop, click Start | Programs | AspenTech | Aspen Basic Engineering V7.1 to display the Aspen Basic Engineering list of installed components.

6 Select Explorer to open the component.

7 Select File | Open Workspace (or click the toolbar icon) and select a Workspace to log on to. The name of the selected Workspace should be displayed in the left pane of the main window.

8 Close the Explorer.

Opening a Diagram

9 On the desktop, click Start | Programs | AspenTech | Aspen Basic Engineering V7.1 and select Drawing Editor to open the component.

10 Select File | Open Workspace, and select a Workspace to log on to.

11 Select File | Open, and select a diagram to open from the list displayed. If none is listed, select File | New to create a new diagram and open it in the main Drawing Editor window.

12 Close the Drawing Editor.


Opening a Datasheet

13 On the desktop, click Start | Programs | AspenTech | Aspen Basic Engineering V7.1 and select Datasheet Editor to open the component.

14 Select File | Open Workspace and select a Workspace to log on to.

15 Select File | Datasheet| by Type and make a selection from the list displayed. Click OK. The selected datasheet is displayed in the Datasheets dialog New tab.

16 Highlight the datasheet you have selected and click Open. This opens the datasheet in the Datasheet Editor main window.

17 Close the Datasheet Editor.

Verifying Component Installation This procedure confirms each installed component opens without error and is available to the user. Exit each component before moving to the next step.

Note: If any component fails to open, or an error message is displayed, inform your System Administrator.

Logging On

1 Log on to your PC as a standard user (with no Administrator privileges).

2 On the desktop, click Start | Programs | AspenTech | Aspen Basic Engineering V7.1 to display the Aspen Basic Engineering list of installed components.

3 Next, move the cursor over the Configuration option to display Configuration components.

4 Click the first component to open it and confirm it is available.

5 Repeat this procedure for the remaining Configuration components, ensuring each component launches without error.

6 Next, move the cursor over the Interfaces option to display Interface components.

7 Click the first component to open it and confirm it is available.

8 Repeat this procedure the remaining Interfaces components, ensuring each component launches without error.

9 Next, open the following components individually ensuring each component launches without error:

o Datasheet Editor

o Explorer

o Drawing Editor

10 On the Windows Start menu, click Start | Programs | Aspen Basic Engineering V7.1; then click Excel Datasheet Generator.

11 On the Excel menu bar, confirm an additional menu item (Generate) has been added. This appears only when the Excel Datasheet Generator component has been opened.

You have verified the Aspen Basic Engineering installation.


Configuring Aspen Basic Engineering

Client Only In general, no additional configuration requirements are necessary.

If the Aspen Basic Engineering client is connected to its server via a network of limited bandwidth, and poor performance of the graphics client is observed, we recommend that the flowsheet symbols be replicated to the local machine. Please refer to the online Help, Configuration/Administration/Managing Workspaces/Symbol Replication topics for details on symbol replication.

Standalone Access RDB Install No additional configuration requirements are necessary if using the default workspace.

Oracle (or SQL) RDB

Note: Only a correct and corresponding Oracle driver/client should be used in conjunction with the Oracle server. See the notes on Oracle versions in Non-AspenTech Software to ensure the same/correct driver and RDBMS version of Oracle is available and installed on your machine(s).

For Oracle (or SQL) RDB installations, the Zyqad Administrator must configure the Workspace for RDB access.

Please refer to the online Help, Configuration/Administration/Managing Workspaces topics, or the Administrator Reference Manual, Managing Workspaces for configuration details.

Note: If a server is used by the Drawing Editor client on remote machines, the default symbol path will not work.

Aspen Batch Distillation This section contains the instructions for verifying and configuring the Aspen Batch Distillation installation.

Verifying an Aspen Batch Distillation Installation 1 Create an empty test folder and copy into it the file HeptHexOct.bspf.

The default directory location of the file is:

C:\Program Files\AspenTech\Aspen Batch Distillation V7.1\Examples\HeptHexOct

2 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Batch Distillation | Aspen Batch Distillation.


3 Click File | Open, and select HeptHexOct.bspf from your test folder.

4 On the menu bar click Run | Run.

After a few moments, the dynamic simulation starts to run.

5 Check that the time in the status bar at the bottom of the window is advancing. The time appears after the words Dynamic at.

6 On the menu bar, click File | Exit.

A dialog box should appear with the message This Will Stop The Current Simulation.

7 Click OK.

8 When prompted to save changes, click No.

Aspen Batch Distillation closes.

You have successfully verified Aspen Batch Distillation.

Aspen Chromatography

Verifying an Aspen Chromatography Installation


To verify an Aspen Chromatography Installation

1 On the desktop, click Start | Programs | AspenTech | Process Development V7.1 | Aspen Chromatography | Aspen Chromatography.

2 On the menu bar, click File | Demonstrations.


3 In the top window, select Separation of D- and L- Threonine enantiomers and click Open.


4 Click OK.

5 In the top pane of the Exploring – Simulation window, click flowsheet.

6 In the lower pane, double-click Axial- Concentration.

A plot opens.

7 On the menu bar click Run | Run.




9 On the menu bar, click Tools | Report | Chromatography Report.


A chromatography report dialog box appears.

10 On the menu bar click File | Exit. When prompted to save changes, click No.

Aspen Chromatography closes.

You have now successfully verified your installation. You can delete the test folder created earlier.

Aspen Custom Modeler This section contains the instructions for verifying the installation of Aspen Custom Modeler on user PCs.

Verifying the Server Installation

Applies to: Aspen Adsorption , Aspen Chromatography, and Aspen Plus Dynamics After you have installed and configured the simulation server software on the server for any Aspen Modeler 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.exe

where:

pathname is the directory location of the file.


C:\Program Files\AspenTech\AMSystem V7.1\bin\ sim_server.exe

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

3 Click OK:

A message similar to the following indicates a successful verification:

sim_server.exe (Version 23.0) built on Nov 5 2008 at 17:40:23

Verifying an Aspen Custom Modeler 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 Modeler V7.1\Examples\5Tank

2 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Custom Modeler | Aspen Custom Modeler.

3 On the menu bar, click File | Open.

4 Navigate to your test folder and click the Fivetank.acmf file; then click Open to load the simulation.

5 On the menu bar, click Run | Mode | Dynamic.


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 words Dynamic at.

8 On the menu bar click File | Exit.

9 When the This will stop the current simulation message appears, click OK.


Aspen Custom Modeler closes.

You have successfully verified your installation. You can delete the test folder..

Verifying an Aspen Custom Modeler

Installation with Aspen Properties You verify an Aspen Custom Modeler installation that uses Aspen Properties by following two steps:

1 In Aspen Plus, create an Aspen Plus document (.apw) file.

2 In Aspen Custom Modeler, run the absorber example simulation.

Step 1: Creating the Aspen Plus Problem Definition (.appdf) file

To create the Aspen Plus problem definition 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 Modeler V7.1\Examples\Absorber

3 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus| Aspen Plus User Interface.


4 In the Aspen Plus Startup dialog box, open the Absorber.bkp file in your test folder.

Note: There is no flowsheet because this is a properties-only input file.

5 On the Aspen Plus menu bar, click Run | Run.

6 After the run completes, on the menu bar click File | Export. In the Save As type field, select Problem Definition File (*.appdf) from the list and save in your test folder as an Aspen Plus problem definition (.appdf) file.

7 Exit Aspen Plus.

Step 2: Running the Absorber Example Simulation

To run the absorber example simulation in Aspen Custom Modeler: 1 On the desktop, click Start | Programs | AspenTech | Aspen

Engineering | Aspen Custom Modeler V7.1 | Aspen Custom Modeler.

2 On the menu bar, click File | Open. Locate your test folder and select the absorber.acmf file. Then click Open.

3 In the All Items pane of the Simulation Explorer, click Flowsheet to select it.

4 In the Contents of Simulation pane, double-click the FeedDisturbance task to activate it.

5 In the Contents of Simulation pane, double-click TempProfile to display the temperature profile plot.

6 In the Contents of Simulation pane, double-click the InitializeSimulation script to run it.

When the script completes, the temperature profile plot displays the result.

7 On the menu bar, click File | Exit. 8 When prompted to save changes, click No.

Aspen Custom Modeler closes.


Aspen Exchanger Design and Rating

Verifying an Aspen Exchanger Design and Rating Installation



To verify the installation of any of the Aspen Exchanger Design and Rating V7.1 design system product on a user PC 1 On the desktop, click Start | Programs | AspenTech | Aspen

Exchanger Design and Rating V7.1 | Aspen Exchanger Design and Rating User Interface

The Aspen Exchanger Design and Rating window appears.

2 On the Aspen Exchanger Design and Rating dialog box, click the Existing tab.

3 Double-click the More Files folder and then navigate to <X>:\Program Files\AspenTech\Aspen Exchanger Design and Rating V7.1\Examples. You will see folders for the various products within Exchanger Design and Rating. Open one of the folders and open any of its files.

4 On the menu bar, click the Run ( ) button.

5 If the following message appears: "No change has been made to the file. Do you still want to run?", click Yes.

The program should open the status window and display the calculation progress.

You are finished with the verification of the Aspen Exchanger Design and Rating installation.

Aspen HYSYS and Aspen HYSYS Upstream

Verifying an Aspen HYSYS Installation

Note: If you have not already done so, restart Windows to activate the changes made to your configuration during the installation. Aspen HYSYS: For Windows Vista Users: Navigate to <X>:\Program Files\AspenTech\Aspen HYSYS V7.1\Samples and copy the sample files to a user-writeable folder. Aspen HYSYS Upstream: For Windows Vista Users: Navigate to <X>:\Program Files\AspenTech\Aspen HYSYS V7.1\Samples\AspenHydraulics\Single Phase and copy the files to a user-writeable folder.

To verify the installation of Aspen HYSYS V7.1 or Aspen HYSYS Upstream on a user PC:

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen HYSYS | Aspen HYSYS.

The Aspen HYSYS V7.1 program window appears.

2 Click the Open Case icon on the Aspen HYSYS toolbar.

Follow these steps to verify an Aspen HYSYS Installation:


3 Navigate to the Samples folder (or, alternatively, to the folder created for Windows Vista users), and open the Aspen HYSYS sample case named Tutor1. Open Mix-100. Select and then clear the Ignore checkbox and verify that the simulation converges correctly

4 In the flowsheet, double click the component Mix-100. In the Properties dialog, select and then clear the Ignore check box. In the message panel, verify that the simulation converges correctly.

5 Close the case.

Follow these steps to verify an Aspen HYSYS UpstreamInstallation:

4 Navigate to the Samples\AspenHydraulics\Single Phase folder (or, alternatively, to the folder created for Windows Vista users) and open mixer.hsc. Verify that the network in the hydraulics subflowsheet converges.

4 Close the case.

5 Navigate to the Sample\AspenHydraulics\Single Phase folder and open mixer dynamic.hsc.

6 Click Continue to restart the integrator. Click No on the Dynamic Assistant warning and verify that the integrator runs without errors or warnings (see bottom left end of the status bar).

7 Close the case.

Aspen MUSE

Verifying an Aspen MUSE Installation

Note: If you have not already done so, restart Windows to activate the changes made to your configuration during the installation. For Windows Vista Users: Navigate to: <X>:\Program Files\AspenTech\HTFS\Aspen MUSE V7.1\Examples, and copy all example files to a user-writeable folder.

To verify the installation of the Aspen MUSE V7.1 design product on a user PC

1 On the desktop, click Start | Programs | AspenTech | Exchanger Design and Rating V7.1 | Heritage Design Tools | Aspen MUSE | Aspen MUSE.

The Aspen MUSE V7.1 program window appears.

2 On the Aspen MUSE dialog box, click the Existing button.

3 Navigate to your user-writable folder (see note above), and open any of the files.

4 On the menu bar click Run | Calculate All.

The program should run and provide the Results Summary.

You are now finished with the verification of the Aspen MUSE installation.


Aspen OnLine This section contains the following sections:

• Configuring Aspen OnLine

• Verifying an Aspen OnLine Installation

Note: If you have an older version of OnLine installed, see "6 Adding and Upgrading Aspen Products," which explains how to back up your existing files so you don’t lose your work.

Configuring Aspen OnLine When the installation of Aspen OnLine is complete, you must configure:

• Aspen OnLine Server.

• Aspen OnLine Client.

Configuring CIM-IO for the Aspen OnLine Server The CIM-IO component for Aspen OnLine must be configured to communicate with the source of plant data.

Note: If another AspenTech application on this computer is using CIM-IO to communicate with the same devices, Aspen OnLine will use the same CIM-IO connection, and you do not need to perform this configuration.

The following instructions assume the plant data server is IP.21. For complete CIM-IO configuration instructions for IP.21 and for all other plant data server devices, see the CIM-IO manual.

Adding Services

To add services to the Windows 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 in numerical order:

If necessary, replace 5801 and 5802 with unused service numbers greater than 1023 that are identical to those in the corresponding file in the IP.21 server computer.

CIMIOSETCIM_200 5801/tcp #CIMIO for IP.21 CIMIOSETCIMH_200 5802/tcp #CIMIO for IP.21 historical

3 Save the file and exit the text editor.


Specifying Logical Devices

To specify the Logical Devices used by CIM-IO in its logical device definition file:

1 Double click the CIM-IO Device Configuration icon in the CIM-IO windows group.

-or- On the desktop, click Start | Programs | AspenTech | Aspen Manufacturing Suite - Information Mgmt | Cim-io | Logical Devices.

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 where IP.21 resides.

Note: These instructions assume the plant data server is IP.21. For your specific device or plant data server, see the CIM-IO manual.

Verifying an Aspen OnLine Installation Perform the following steps to verify that Aspen OnLine is installed and functional.

1 Verify plant data access on the server machine.

2 Verify relevant Aspen products on the server machine.

3 Verify Aspen OnLine on the server and client machines.

Verifying Plant Data Access To verify plant data access on the server machine, follow the instructions in “The CIM-IO Test Utility” section of the Aspen OnLine User Guide.

Verifying Aspen Products Aspen OnLine can drive Aspen Plus models and models from Aspen Custom Modeler and related products such as Aspen Utilities.

• If Aspen OnLine V7.1 is used to drive Aspen Plus models, verify that Aspen Plus V7.1 has been correctly installed on the server machine.

• If Aspen OnLine V7.1 is used to drive Aspen Custom Modeler and related product models, verify that Version V7.1 of the corresponding Aspen Custom Modeler products has been installed properly.


Verifying Aspen OnLine

To verify Aspen OnLine on the server machine:

Server Machine

1 Go to the installed Aspen OnLine V7.1 product folder and copy the subfolder, AOLSample, to a location under one of the local drives on the server machine.

2 On the desktop, click Start | Programs | AspenTech | Operations Support V7.1 | Aspen OnLine | Aspen OnLine Project Manager.

The Aspen OnLine Project Manager window appears.

3 For Computer enter the name of the server machine.

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

The new project name appears in the list in the Aspen OnLine Project Manager window.

6 Click OK to register the sample project and close the dialog box.

7 Click Close to exit the Project Manager.

8 On the desktop, click Start | Programs | AspenTech | Operations Support V7.1 | Aspen OnLine | Aspen OnLine Client GUI.

The Aspen OnLine window appears.

9 On the Aspen OnLine Startup dialog box,

o Specify the Server name (Step 3)

o Select AOLSample as project name.

10 Click OK.

11 Perform offline to online for both models in the project.

12 In the Steady-state detection frame, click Load.

13 After the program is loaded, click Start. 14 In the frame on the right, do the same to start the Aspen OnLine engine.

Aspen OnLine is running.

Client Machine

To verify Aspen OnLine on the client machine: 1 On the desktop, click Start | Programs | AspenTech | Aspen

Engineering | Aspen OnLine V7.1 | Project Client GUI.

The Aspen OnLine window appears. 2 On the Aspen OnLine Startup dialog box, specify the server name and

project name.


3 Click OK.

4 Make sure that Aspen OnLine is running on the server machine.

5 On the Aspen OnLine menu bar, click Data | Data Browser.

The Data Browser window appears.

The information displayed in the Data Browser should reflect the project information for the specified project on the specified server machine.

Aspen Plus This chapter contains the following sections:

• Configuring Microsoft SQL Server or SQL Express

• Verifying the Aspen Properties Enterprise Database Installation

• 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

• Installing Aspen OLI Interface

• Verifying an Aspen OLI Interface Installation

Configuring Microsoft SQL Server or SQL Express In order to use the Aspen Properties Enterprise Database with Aspen Plus or Aspen Properties, a SQL server is required. If that server is the SQL Express installed with Aspen Plus or Aspen Properties, no further configuration is required. If, however, a pre-existing Microsoft SQL Server or SQL Express is used, follow these steps to ensure SQL Server and Windows authentication mode is enabled.

Note: Aspen Properties Enterprise Database no longer uses Microsoft SQL Server Desktop Edition (MSDE) or MS SQL Server 2000 due to problems encountered with these SQL servers.

On Microsoft SQL Server:

1 Run Start | Programs | Microsoft SQL Server | Enterprise Manager. 2 In the tree on the left, right-click the name of the server and select

Properties. The SQL Server Properties (Configure) dialog box appears.

3 Click the Security tab.

4 Under Authentication, select SQL Server and Windows, and click OK.

On SQL Server Express, the user interface for configuring the server is not installed by default. If you do not have it, download it from Microsoft: http://www.microsoft.com/downloads/details.aspx?FamilyId=C243A5AE-


4BD1-4E3D-94B8-5A0F62BF7796&displaylang=en and install it before performing these steps:

Run Start | Programs | Microsoft SQL Server 2005 | SQL Server Management Studio Express.

The Connect to Server window appears.

5 Select the server name and Windows Authentication. Click Connect. The Microsoft SQL Server Management Studio Express window appears.

6 In the tree on the left, right-click the name of the server and select Properties. The Server Properties dialog box appears.

7 At the left, click Security.

8 Under Server authentication, select SQL Server and Windows authentication mode, and click OK.

Verifying the Aspen Properties Enterprise Database Installation 1 On the desktop, click Start | Programs | AspenTech | Process

Modeling V7.1 | Aspen Plus | Aspen Properties Database Configuration Tester.

2 When the Database Configuration Tester window appears, click Start.

The tester will perform several tests and report the results.

• License availability: The tester verifies a license for Aspen Plus or Aspen Properties is available.

• Configuration file permissions: The tester verifies that the configuration file was installed with the correct permissions.

• SQL engine authentication settings: The tester reports all servers that have at least one Aspen Properties database that is registered on this computer. On the localhost line, it reports the authentication mode of the local server and whether there is any problem with it. For other servers it cannot check this status, so it only reports what is required.

• Database access settings: The tester attempts to access each registered database and performs three tests. o First, it verifies that it can connect to the database at all, with either a

Connection Successful message or a message indicating the error that occurred.

o Next, it attempts to read the database as Aspen Plus or Aspen Properties would do. This should report Granted/Successful if the database is configured for access from these programs, or Denied/Failed otherwise. For a non-customized new installation, the databases APV71, NISTV71, and FACTV71 should all be accessible.

o Finally, it attempts to read the database as the Database Manager would do. This should also report Granted/Successful or Denied/Failed based on the security options. For a non-customized new installation, the databases APV71, NISTV71, and FACTV71 should all be accessible.

http://www.microsoft.com/downloads/details.aspx?FamilyId=C243A5AE-4BD1-4E3D-94B8-5A0F62BF7796&displaylang=en

http://www.microsoft.com/downloads/details.aspx?FamilyId=C243A5AE-4BD1-4E3D-94B8-5A0F62BF7796&displaylang=en


Verifying an Aspen Plus/Aspen Polymers Installation


To verify an installation of Aspen Plus on a user PC:

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus | Aspen Plus User Interface.

2 For Aspen Plus: In the Aspen Startup dialog box, open the existing simulation test file, pfdtut.bkp. The default location is:

C:\Program Files\AspenTech\Aspen Plus V7.1\GUI\XMP

If the Connect to Engine dialog box appears: o See "Configuring a Windows Server as an Aspen Host" to

configure Aspen Plus to locate the server.

-or- o Click OK to run the engine locally.

For Aspen Polymers: Navigate to the test file, polytut.bkp.

The default directory location is:

C:\Program Files\AspenTech\Aspen Plus V7.1\GUI\xmp\ Polymers

3 On the menu bar, click View | Control Panel.


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

The Results Summary window appears, showing the run completion status.

You are now finished with the verification of the Aspen Plus or Aspen Polymers installation.

Configuring a Windows Server as an Aspen Plus Calculation Server This section explains how to configure a Windows server as an Aspen Plus engine host. This configuration allows the user to submit Aspen Plus runs by connecting to a remote host.


These are the steps for installing and configuring an Aspen Plus calculation 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.

Step 1: Install the Simulation Engine on the Server

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 the section "Client-Server Installation."

2 When the Feature Selection dialog box appears, select and expand Aspen Plus V7.1 by clicking on the PLUS SIGN.

3 Click Aspen Plus V7.1 Engine to install it and all its subfeatures.

4 Click Next and continue the Aspen Plus installation setup on the server machine.

Step 2: Verify the Simulation Engine Installation on the Server 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 V7.1\Engine\XEQ

2 Copy the file INSTPROB.INP to this directory:

\AspenTech\Working Folders\Aspen Plus V7.1

3 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus| Aspen Plus Simulation Engine.

This launches a DOS window and sets up the user environment to run the Simulation Engine.

4 At the command prompt, type the following and press ENTER:

aspen instprob /getridof

This command runs the problem and deletes the working files.

Any errors are reported in the instprob.out file, located in \AspenTech\Working Folders\Aspen Plus V7.1.


If there are problems running the simulation, see "Troubleshooting Aspen Plus."

Step 3: Set Up User Access to the Calculation Server After you complete the installation of the Aspen server components on the server machine, you must configure the server as an Aspen host. Each user who connects to the Windows server must 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 must also be granted Log on as a Batch Job access to the server.

For detailed instructions, see "Configuring a Windows Server as an Aspen Host."

Step 4: Create Working Directories for Users Allowing each user to have a dedicated directory prevents working files from overlapping. The Permissions you can set for the working directories depend on the format of the disk partition where the working directory resides.

Format Permissions

NTFS Folder and sharing

FAT Sharing only

Note: If you do not define working directories, the default is the system32 directory of the server. Do NOT allow users to run jobs in this directory.

To create working directories for users

1 Log on to the Windows 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/or Change permissions. This allows users to transfer Fortran source files to each other’s working directories.

Step 5: Install Aspen Plus on User PCs

To install Aspen Plus on a user PC 1 On the user PC, perform a Standard installation of Aspen Plus, following

the instructions in Standard Installation.

2 Click Next to continue the Aspen Plus installation setup on the user PC.


Step 6: Verify the Calculation Server Installation After you perform Steps 1-5, verify client access to the calculation server.

To verify the installation

1 On the desktop of the user PC, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus | Aspen Plus User Interface.

2 Open the test file PFDTUT.BKP. The default location is:

C:\Program Files\AspenTech\Aspen Plus V7.1\GUI\XMP

3 On the Aspen Plus menu bar click Run | Connect to Engine.


Note: The Connect to Engine dialog box may appear automatically.

4 For the Server type, click Windows server.



o User name

o User’s password

o Appropriate working directory


Note: If you are using domain accounts, the Domain Name must precede the username. For example, MAGIC\potterh would be a valid login for the MAGIC domain.



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 display should look similar to this.

Aspen Plus Client/Server Communication The Aspen Plus User Interface communicates with the Simulation Engine using several TCP/IP and DCOM protocols. These protocols allow users to log on to Aspen Plus and execute programs on the Simulation Engine when the engine is running on a remote host.

The operating system and communication protocol determine the behavior of processes on the remote host running the Aspen Plus Simulation Engine.

When the User Interface connects to a remote host, two processes start on the remote host:

• Xcserver

• Apmain


Displaying and Stopping a Process You can always verify the existence of dangling processes and stop them manually, if necessary, before they terminate themselves.

To stop an Aspen Plus process manually

1 On the desktop. right-click the Task Bar; then click Task Manager on the menu.

2 In the Task Manager window, click the Processes tab.

3 Select the process you want to stop; then click End Process.

Customizing Aspen Plus Communication The mm.ini file determines how the User Interface communicates with the Simulation Engine. This file contains a number COMMSECT sections, each containing a set of parameters for a different remote connection type.

You can use the mm.ini file to customize communication for the User Interface. The default location is:

C:\Program Files\AspenTech\Aspen Plus V7.1\GUI\xeq

Changing Timeout Variables You can adjust the following variables, contained in each section of 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, as follows:

Variable name How long to wait Default value

connect_timeout During the login process for the xcserver.exe process to connect to the client again

90 seconds

rcmnd_timeout For a response from the xcserver.exe process 90 seconds

inter_timeout For a response from the apmain.exe process 90 seconds

Troubleshooting Communication Problems You can use the mm.ini file to debug communication problems between the User Interface and Simulation Engine, even if both programs reside on the same host. By default, the mm.ini file resides on the host running the User Interface in \AspenTech\Aspen Plus V7.1\GUI\xeq.

The mm.ini file contains this line:

debug OFF

When debug is set to ON, processing and debugging status messages appear in the Control Panel of the Aspen Plus User Interface window.


Using the FORTRAN Compiler with Aspen Plus Running an Aspen Plus simulation requires a FORTRAN compiler if 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 FORTRAN subroutines into a shared library (DLL). This library can be distributed to Aspen Plus users who do not have an installed FORTRAN compiler.

User Workflow 1 The user writes the external FORTRAN subroutine, using his choice of

editor.

2 The user copies the file to his/her working directory on the server machine, by dragging and dropping the file to the shared directory or mapping a local drive to the shared directory.

3 The user telnets into his account on the server machine, using his choice of Telnet client software. The built-in Telnet client software shipped with Windows works fine.

4 The FORTRAN source file can be compiled using the ASPCOMP command. You can exit from the Telnet session and return to the Aspen Plus User Interface.

5 The user connects to the calculation server machine from the Aspen Plus User Interface and runs the simulation in his/her working directory. The compiled FORTRAN object file will be used during the simulation run.

Installing the FORTRAN Compiler

Client-Server Installations You must access a FORTRAN compiler on the calculation server if a simulation either:

• Refers to external FORTRAN subroutines

• Contains non-interpretable FORTRAN

Users running external FORTRAN subroutines must copy the FORTRAN files to the server and compile them in their working directory on the server. These compiled object files are used during the simulation run initiated by the client PC.

When installing the FORTRAN compiler, we recommend that you change the installation directory to C:\MDS.

After file copying is completed, the installer program asks if you want to configure the Environment Variables for Windows. Click Yes to ensure that every user has access to the FORTRAN compiler. On the next prompt, to install the Array Virtualizer, click No.


TelnetD Server Compiling FORTRAN subroutines on the Windows calculation server, requires a TelnetD server. The following table lists commercially available TelnetD packages, along with any known conflicts with existing AspenTech software. All of the vendors listed offer trial versions of their software, available at their websites.

Vendor Product Contact Information

Ataman* TCP Remote Logon http://www.ataman.com

Georgia Softworks

Telnet Server http://www.georgiasoftworks.com

Pragma Systems*

InterAccess Telnetd Server Version 4 htttp://www.pragmasys.com

Seattle Labs SLNet http://www.seattlelab.com/

* Loads a REXECD service that conflicts with the AspenTech REXECD. See the vendor documentation to disable this service.

Verifying the Installation of the FORTRAN Compiler After you install the FORTRAN compiler and TelnetD Server on the server, you need to verify that they are operating properly. The verification uses two example files: DRSEX14.BKP and DRUSR0.F.

To verify the installation of the FORTRAN Compiler:

1 Copy the file DRUSR0.F, located in the \Aspen Plus V7.1\GUI\XMP directory, to the working directory of a user account on the Calculation Server.

2 Open the Windows Telnet program. Log into the Calculation Server with a valid account and password.

3 Go to the correct working directory and compile the FORTRAN file using the command:

aspcomp drusr0.f

4 On the desktop of the client machine, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus | Aspen Plus User Interface.

5 Open the file DRSEX14.BKP, located in the \Aspen Plus V7.1\GUI\XMP directory.


6 For the Server Type select Windows server.



o User name

o User’s password

o Appropriate working directory


Note: If you are using domain accounts, the Domain Name must precede the username. For example, MAGIC\potterh would be a valid login for the MAGIC domain.



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 display should look like this:

Aspen OLI Interface


This section contains the instructions for verifying the installation of the Aspen OLI Interface on user PCs.

Verifying an Aspen OLI Interface Installation

Note: To use Aspen OLI, Aspen Plus must be installed prior to or simultaneously with Aspen OLI. The OLI Alliance Suite for Aspen OLI V7.1, available from OLI, must also be installed.

To verify the installation of Aspen OLI on a user’s computer:

1 If you have not already done so, restart Windows to include changes made to your configuration during the installation.

2 Click Start | Program Files | AspenTech | Process Modeling V7.1 | Aspen OLI | Chemistry Generator (or Chemistry Wizard).

The Chemistry Generator (or Chemistry Wizard) window opens.


You can also verify your installation by checking that files were installed to the desired installation directory.

To verify your installation this way

• Open Windows Explorer; then navigate to the destination directory:

Note: If you specified a different destination directory, you must navigate to that location instead.

C:\Program Files\OLI Systems\Alliance Suites\Aspen OLI V7.1

You should find these subdirectories:

• AccessDB.

• Chemistry Generator.

• Chemistry Wizard.

• Data Locator.

• Databanks.

Verifying an Aspen Distillation Synthesis feature of Aspen Plus Installation Use the following procedures to verify an installation of the Aspen Distillation Synthesis feature of Aspen Plus on a user PC.

Verifying the Aspen Distillation Synthesis Component

o Because the Aspen Distillation Synthesis component runs under Aspen Plus, first verify the installation of Aspen Plus. For more information see Verifying an Aspen Plus/Aspen Polymers Installation.

o Next, it attempts to read the database as Aspen Plus or Aspen Properties would do. This should report Granted/Successful if the database is configured for access from these programs, or as Denied/Failed otherwise. For a non-customized new installation, the databases APV70, NISTV70, and FACTV70 should all be accessible.

o Finally, it attempts to read the database as the Database Manager would do. This should also report Granted/Successful or Denied/Failed based on the security options. For a non-customized new installation, the databases APV70, NISTV70, and FACTV70 should all be accessible.

To verify the installation of the Distillation Synthesis component:

To verify the installation of the Distillation Synthesis component:

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus | Aspen Plus User Interface.

2 In the Aspen Plus Startup dialog box, select Open an Existing Simulation. Then select More Files and click OK.

3 In the Open dialog box, click the Look in Favorites folder icon. Then open Applications, click 3phase.bkp; then click Open.


4 If a message appears saying you do not have write access to this folder so Aspen Plus is selecting a new working folder, click OK.

5 In the Connect to Engine dialog box, select Local PC for the Server type; then click OK.

6 On the Aspen Plus menu bar, click Tools | Conceptual Design | Ternary Maps to start the Distillation Analysis component.

The Ternary Maps window appears within the Aspen Plus Window, for example:

7 For Comp 3 select MCACET from the list of components.

8 In the Explorer tree click Ternary Plot to start the calculations for generating the ternary map.

When the calculations are complete the ternary map that is generated should look like this:

You have successfully verified your installation.


Aspen Plus CatCracker/Hydrocracker/ Hydrotreater/Reformer

Configuring an Aspen Plus CatCracker/Hydrocracker/ Hydrotreater/Reformer Installation

To configure the Aspen Plus CatCracker installation:

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus Based Refinery Reactors | Aspen Plus CatCracker (or Hydrocracker /Hydrotreater/Reformer).

The Microsoft Excel window containing the Aspen Plus CatCracker (or Hydrocracker /Hydrotreater/Reformer) worksheet tabs appears. 2 On the Excel menu bar, click Tools | Options.

The Options window appears.

3 In the Options window, click the Security tab.

4 On the Security tab, click Macro Security.

The Security dialog box appears.

5 On the Security dialog box, click the Security Level tab; then click Medium.

6 Click OK to accept the new macro security level settings and close the Security dialog box.

7 In the Options window, click OK.

Aspen Plus Dynamics This section contains the instructions for verifying the installation of Aspen Plus Dynamics on user PCs.

Verifying an Aspen Plus Dynamics Installation

To verify an installation of Aspen Plus 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 Plus Dynamics V7.1\Examples


2 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Plus| Aspen Plus User Interface.

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 properly connected to the remote server.


5 When the run completes, on the menu bar, click File | Export.

6 Navigate to your test folder, and for the Save as Type, click 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 Plus Dynamics starts automatically, with the DyEster simulation open.


After a few moments, the dynamic simulation starts to run.

10 Make sure that the time shown in the status bar at the bottom of the window is advancing.

The time appears after the words Dynamic at. 10 On the menu bar, click File | Exit.

11 When the This will stop the current simulation message appears, click OK.


Aspen Plus Dynamics closes.


Aspen Properties This section contains the following sections:

• Verifying the Aspen Properties Installation

• Setting Up the Aspen Properties Web Interface

• Configuring IIS for Aspen Properties Web Interface

• Configuring Excel for Performing Property Calculations

• Restricting User Access Using File Permissions

• Setting up Properties Web Interface Userfolders

• Running the Aspen Properties Web Interface

Verifying an Aspen Properties Installation



To verify the installation of Aspen Properties on a user PC

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Properties | Aspen Properties User Interface.

2 In the Aspen Properties Startup dialog box, click Template; then click OK.

3 Select General with English Units; then click OK.

If the Connect to Engine dialog box appears:

• See Specifying a Remote Server to configure Aspen Properties to locate the server

-or-

• Click OK to run the engine locally.

The Components Specifications Selection sheet appears.

4 Define these components:

o water

o ethanol

5 Go to the Databanks sheet and verify that the following databanks are listed in the Selected databanks column:

o PURE13

o AQUEOUS

o SOLIDS

o INORGANIC

6 Return to the Components Specifications Selection sheet, and press F1 to display Help on Components Selection.

7 Click Review.

The Properties Parameters Pure-Component Review-1 form appears. Parameters such as API, CHARGE, DGFORM, for the components should be displayed.

8 Click Next to display the Properties Specifications Global sheet and specify:

Property Method = NRTL (Top right corner field, select from the list)

9 Click Next to display the Properties/Parameters/Binary Interaction/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 for Component 1 and Component 2.

12 Click Go to perform the analysis.

When complete, the Binary Analysis Results dialog box and the Txy plot should appear.

13 In the Binary Analysis Results dialog box, click on Plot Wizard.


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 successfully verified your installation.

Setting Up the Aspen Properties Web Interface Aspen Properties Web Interface, a component of Aspen Properties V7.1, is a Web-browser interface that enables users to quickly look up physical property information or to perform property calculations.

These are the system requirements for Aspen Properties Web Interface:

• Microsoft Internet Information Server (IIS) must be installed. Restart your computer after the IIS install.

• Aspen Properties V7.1 must be installed on the machine running the web server.

Note: Only a system administrator should setup and configure Aspen Properties Web Interface.

To set up Aspen Properties Web Interface for deployment

1 On your Windows XP or Vista web server machine, install Aspen Properties V7.1, using the Standard install option.

For instructions see "Standard Installation." 2 Configure IIS for Aspen Properties Web Interface.

For instructions, see Configuring IIS for the Aspen Properties Web Interface.

3 Set up Properties Web Interface user folders to store problem files on the web server.

For instructions, see “Setting Up Properties Web Interface User Folders."

Configuring IIS for the Aspen Properties Web Interface After you install Aspen Properties on the web server, you must configure the Internet Information Server (IIS) for Properties Web Interface.

To configure IIS for Aspen Properties Web Interface:

1 On your desktop click Start | Settings | Control Panel | Administrative Tools | Internet Information Services.

2 In the console tree expand Internet Information Server | <your_IIS_server_name> | Web Sites.

3 Right click Default Web Site and click New | Virtual Directory on the menu.


4 In the Virtual Directory Creation Wizard, click Next to continue.

5 Enter WebProperties as the Alias to be used to access the virtual directory. Then click Next to continue.

6 Click Browse and locate the WebProperties directory. For example:

D:\Program Files\AspenTech\Aspen Properties V7.1\WebProperties


8 For the Access permissions, select:

o Read

o Run scripts

o Execute

9 Click Next. 10 Click Finish.

The WebProperties folder appears under the Default Web Site in the console tree.

11 Set up access security for valid users of Aspen Properties Web Interface.

For instructions, see “Setting Up Directory Security” below.

12 Provide access to Out-of-Process (OOP) COM objects.

For instructions, see "Providing Access to Out-Of-Process (OOP) COM Objects."

Setting Up Directory Security

To set up access security for Aspen Properties Web Interface 1 In the console tree of the Internet Service Manager, right-click the

WebProperties Default Web Site; then click Properties on the menu.

2 Display the Virtual Directory tab and click the High (isolated) option for Application Protection options. Then click OK.

3 Restart the Web Server service. This can be done by right-clicking on <your_IIS_server_name> and selecting the All Tasks | Restart IIS... option. Pick the option Restart Internet Services on <your_IIS_server_name> and click OK.

4 In the console tree of the Internet Service Manager, right-click the WebProperties Default Web Site; then click Properties on the menu.

5 Grant the access rights to valid users of Aspen Properties Web Interface at your site.

For example, to display the Windows authentication dialog box when a user wants to access Aspen Properties:

1 On the Properties dialog box, display the Directory Security tab and click the Edit button for Anonymous Access and Authentication Control.

2 In the Authentication Methods dialog box:

o Select the Integrated Windows authentication check box.

o Clear the Anonymous access check box.

o Clear the check boxes of the other options.


3 Click OK, and then click OK again to close the dialog box.

Providing Access to Out-Of-Process (OOP) COM Objects The IWAM_<your_IIS_server_name> accounts must include permissions to launch and access OOP COM objects to run Web Properties successfully.

To add permission to access OOP COM objects 1 On the server machine, click Start | Run. On the Run dialog box enter

dcomcnfg and click OK.

2 Open Component Services | Computers | My Computer. 3 Right-click My Computer and select Properties.

4 Display the COM Security tab. In the Access Permissions section, click Edit Default.

5 On the Access Permission dialog box, click Add.

6 On the Select Users, Computers, or Groups dialog box, click Locations and select <your_IIS_server_name>. Then add these accounts:

o IUSR_<your_IIS_server_name>. This is a built-in account with guest privileges that gives anonymous access to IIS.

o IWAM_<your_IIS_server_name>. This is a built-in account with guest privileges for IIS to start out of process applications.

o Everyone or other <specific user names> according to who you want to access the Web Server.

Note: In order to select specific user names, you may need to click Locations again and select the appropriate domain containing those user accounts.

7 Click OK.

8 On the Access Permission dialog box click OK.

9 In the Launch and Activation Permissions section on the COM Security tab, click Edit Default.

10 On the Launch Permission dialog box click Add.

11 On the Select Users, Computers, or Groups dialog box, add the same accounts from the same locations as you added to the Access Permission in step 6.

o IUSR_<your_IIS_server_name>. This is a built-in account with guest privileges that gives anonymous access to IIS.

o IWAM_<your_IIS_server_name>. This is a built-in account with guest privileges for IIS to start out of process applications.

o Everyone or other <specific user names> according to who you want to access the Web Server.

12 Click OK.

13 On the Launch Permission dialog box click OK.

14 Click OK to close the My Computer Properties dialog box.


Note: If you give access to Everyone, make sure that Everyone has Guest access permissions on the computer.

Restricting User Access Using File Permissions If the file system on the server is NTFS, then user access to the Aspen Properties Web Interface can be controlled using file permissions. For example, if your Aspen Properties installation is on:

D:\Program Files\AspenTech\Aspen Properties V7.1\WebProperties

then you can restrict permission to the:

D:\Program Files\AspenTech\Aspen Properties V7.1\WebProperties\Files

folder by right-clicking on the folder and choosing Properties. On the Security tab of the dialog box, pick the users you want to have access to the application.

Setting Up Properties Web Interface User Folders Users of Properties Web Interface need a place to store their problem files on the web server. You must create the WebProperties user folder directory and specify the location in these Properties Web Interface files:

• Userfolder.inc

• Userfolder.js

Both files are located in the \AspenTech\Aspen Properties V7.1 \WebProperties\Custom directory.

To set up the storage directory for Properties Web Interface user files on the web server

1 Create a directory under which Properties Web Interface users can store problem files.

For example: E:\WebPropsUsers

2 In this directory, create a folder for each Properties Web Interface user.

For example: E:\WebPropsUsers\username1

3 Edit Userfolder.inc in the \AspenTech\Aspen Properties 2006\WebProperties\Custom directory and specify the UserFolder on your web server.

For example:

<% Dim UserFolder UserFolder = "E:\WebPropsUsers" %>

Use quotation marks to enclose the pathname.


4 Edit Userfolder.js in the \AspenTech\Aspen Properties 2006\WebProperties\Custom directory and specify top.userFolder on your web server.

For example:

top.userFolder = "E:\\WebPropsUsers";

Use quotation marks to enclose the pathname.

Use \\ to delimit subdirectories.

Running the Aspen Properties Web Interface Open Internet Explorer on the server machine and use the URL: <http://localhost/webproperties>

You should be able to access the Aspen Properties Web Interface.

From any other client machine open Internet Explorer and use the URL: <http://<your_IIS_server_name/webproperties>

You should be able to access the Aspen Properties Web Interface.

Note: If a user is unable to access the Web application as specified above, the most likely reason is the lack of adequate security privileges provided to the user in the previous steps.

Configuring Excel for Performing Property Calculations Before you can use the Excel Calculator feature to perform property calculations with Aspen Properties from within a Microsoft Excel workbook, you must configure Excel to use an add-in.

For detailed instructions on configuring Excel, see the Aspen Properties online help under Using Aspen Properties | Aspen Properties Excel Calculator | Configuring the Excel Add-in.

Note: If you are upgrading from a previous version of Aspen Properties, you must reconfigure Excel to use the new version of the add-in before Excel will use the new version of Aspen Properties.


Aspen Remote Simulation Service

Configuring Aspen Remote Simulation Service The service normally uses port 8085. You may need to change it in certain cases, such as if another program on that computer uses that port, or you need to use a particular port to connect through a firewall. To change the port which the service uses, edit Program Files\AspenTech\Aspen Remote Simulation Service V7.1\server.config in Notepad.

Locate the line

<channel ref="tcp" port="8085">

And change the number to the port you want to use, for example:

<channel ref="tcp" port="8099">

Running Aspen Remote Simulation Service (ARSS) Aspen Remote Simulation Service™ is a component that provides a remote execution environment for other AspenTech tools including Aspen Simulation Workbook and Aspen Model Deployment. ARSS allows model developers to deploy models onto a server accessible to several client computers.

AspenTech simulation software must be installed on the server, but it is not required on the client computers. This significantly reduces the installation requirements for the client computers.

Note that any remote software interacting with ARSS should have additional specific information necessary for its use; for instance, Aspen Simulation Workbook includes the Aspen Remote Simulation Service Status Monitor and documentation on how to use it.

Tip: It is a best practice to use ARSS on the same computer as the simulation-creating software.


Aspen Solubility Modeler

Configuring an Aspen Solubility Modeler Installation

To configure Excel to use the Aspen Properties Add-in: 1 Start Microsoft Excel from the Start menu. Do not open any existing

spreadsheet.

2 In the Excel menu bar, click Tools | Add-Ins.

If Aspen Properties appears in the list of Add-Ins and is checked, click Cancel and check which version of Aspen Properties Excel Calculator is installed by selecting Aspen | Aspen Properties | About Aspen Properties. The version number appears below Aspen Properties Excel Calculator near the top of the About message that appears.

o If the version of Aspen Properties Excel Calculator is equal to or newer than the version of Aspen Solubility Modeler, skip to step 7.

o If the version of Aspen Properties Excel Calculator is older than the version of Aspen Solubility Modeler, open Tools | Add-Ins again and clear the checkbox by Aspen Properties. Then close all Excel windows and restart this procedure at step 1.

If Aspen Properties appears in the list of Add-Ins and is not checked, or it does not appear in the list of Add-Ins at all, continue with step 3.

3 In the Add-Ins window, click Browse.

4 Locate AspenProperties.xla in the Aspen Properties V7.1\Engine\xeq folder. Click OK. Aspen Properties should be added to the Add-Ins list, with the box next to it checked.

Note: If a previous version of Aspen Properties had been installed in Excel but was uninstalled, Excel will prompt you to overwrite the Add-In entry with the new one you selected: A file named '<path>\Engine\xeq\Aspen Properties.xla' already exists in this location. Do you want to replace it? Click Yes. The message seems to indicate Excel is replacing the .xla file you just selected, but actually it is just replacing the entry in the Add-Ins list.

5 Click OK to close the Add-Ins window. The Aspen menu should be added to the menu bar.

Note: In Excel 2007, the menu appears on the Add-ins tab of the ribbon.

6 In the Aspen menu, select Aspen Properties | User Options. Check the box Suppress messages related to invalid input. Click OK.

7 When Excel asks whether you want to make these your default settings, click Yes.

To launch Aspen Solubility Modeler: 1 On the desktop, click Start | Programs | AspenTech | Process

Development V7.1 | Aspen Solubility Modeler | <any of the packages>.


The first time you start Aspen Solubility Modeler, the Security Warning appears.

2 Click Always trust macros from this publisher, then click Enable

Macros to enable Aspen Solubility Modeler to run and prevent this message from appearing in the future.

3 If this message appears:

Click Don't Update. This message is not related to Aspen Solubility Modeler.

4 Some of the workbooks use ActiveX controls to perform special calculations such as property analysis and phase diagrams. If this window appears:

Click Yes to enable the ActiveX controls supplied with Aspen Solubility Modeler.


5 When the network or local computer is slow, it may take up to a few minutes to check out the license or initialize ActiveX controls. During this time, the following message may appear once or several times:

Click OK as many times as necessary until the Excel workbook fully initializes.

Aspen Utilities Planner Aspen Utilities On-Line Optimizer Aspen Utilities On-Line Optimizer is a solution that consists of Aspen Utilities Planner, Aspen Online, and CIMIO. The Aspen Utilities Planner and Aspen Online installation, configuration, and verification are outlined in this document. Please refer to the Aspen Manufacturing Suite DVD for CIMIO documentation.

Verifying an Aspen Utilities Planner Installation Use the following procedure to verify an installation of Aspen Utilities on a user PC:


To verify the installation of the Aspen Utilities Planner V7.1 product on a user PC:

1 On the desktop, click Start | Programs | AspenTech | Process Modeling V7.1 | Aspen Utilities Planner | Aspen Utilities Planner.

2 Open the example.auf file in the Aspen Utilities Planner working folder.


Aspen Utilities Planner takes a few seconds to run the simulation. The simulation should run with no errors.

To verify the Aspen Utilities Planner V7.1 Microsoft Excel Add-in:

1 Start Microsoft Excel 2003 or 2007.

2 On the menu click Aspen Utilities | Open Aspen Utilities.


3 Navigate to the Aspen Utilities Planner working folder and open example.auf.

A Ready message appears when Aspen Utilities Planner has opened.

4 On the menu bar, click Aspen Utilities | Optimization | Editors.

5 When the Aspen Utilities Planner Data Editors window opens, at the top, click Commit.

6 Click Apply; then close the editor.

7 On the menu bar, click Aspen Utilities | Optimize Flowsheet.

The optimization should complete with no errors.

8 Close Aspen Utilities and Microsoft Excel.

142 6 Adding and Upgrading Aspen Products

6 Adding and Upgrading Aspen Products

This chapter describes the procedures you should follow if you are adding Aspen Engineering products or upgrading previously installed Aspen Engineering products.

Adding Aspen Engineering Products The process of adding Aspen Engineering products is the same as installing Aspen Engineering Products. The only differences is that you must click Modify on the Program Maintenance screen when it appears. On the Feature Selection dialog box, select the additional Aspen Engineering products you want to install.

Upgrading Aspen Engineering Products

Before You Upgrade Before you upgrade any existing Aspen product:

• Create forward-compatible backups of your current projects and store them in a safe location. Binary files are not compatible across different versions of Aspen products.

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

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

6 Adding and Upgrading Aspen Products 143

Aspen OnLine Users

To back up your projects for Aspen OnLine: 1 Launch Aspen OnLine.

2 Click File | Export.

The Export Project Configuration Information window appears.

3 On the Project tab, set the Destination Directory to the directory where you want your old project files to be stored.

4 Click Export.

If you have any Beta products installed, uninstall them before installing the new versions of those products.

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

Product Upgrade Task Summary The following table summarizes the tasks you should perform to prepare for an Aspen software upgrade. An asterisk (*) indicates the recommendation that you keep the previous version on your machine (if there is sufficient disk space) until you are satisfied with the installation of the new version.

Before you upgrade do this

Aspen Adsorption* Create language (.ada) file versions for forward compatibility and store them in a safe location.

Aspen Batch Distillation Create language (.bspf) file versions for forward compatibility and store them in a safe location.

Aspen Batch Process Developer*

Create a backup of project files and store them in a safe location. After you install the latest version, update the existing project files. For instructions, see “Updating Aspen Batch Process Developer Project Files."

Aspen Chromatography* Create language (.cra) file versions for forward compatibility and store them in a safe location.

Aspen Custom Modeler* Create language (.acmf) file versions for forward compatibility and store them in a safe location.

Aspen HTFS+ (Tasc+, Acol+, Plate+, Hetran, Aerotran, Teams)

Save copies of customized cost files to a safe location.

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

Aspen Plus Create backup (.bkp and .apmbd) versions of files from Aspen Plus 12.1 or earlier for forward compatibility and store them in a safe location. Newer Aspen Plus files contain an embedded backup file which will be read by later versions.

If you have Excel Calculator blocks in your runs from Aspen Plus V7.0 or earlier, you need to choose whether to run the new or old version of the Excel add-in for the


Calculator block. The new version is written as a COM add-in and resolves many of the problems users have experienced with previous versions. This new version is the default, but using it in files created with the old version requires that you disable the old version of the add-in in order to upgrade your old files to the new version.

• A utility is available in the Start menu under Programs | AspenTech | Process Modeling V7.1 | Aspen Plus to switch between the new and old versions of the add-in. Users of the old add-in who are not experiencing any problems may wish to continue using the old version. To do so, they merely need to run this utility and select the XLA version before opening any files with Excel Calculator blocks in Aspen Plus V7.1.

• Files created in previous versions using the XLA version of the add-in contain references to the Excel version of the add-in, and will try to use it if this add-in is active, and thus it will not work properly, as Aspen Plus will be trying to use the COM version. The XLA version will be active on computers where it has been used with previous versions of Aspen Plus, even if you have used the utility to select the COM version. You must first disable the old version in Excel by selecting Tools | Add-ins, and clearing the checkbox next to Calcexceladdin. Then close Excel entirely before opening your Aspen Plus files containing Excel Calculator blocks.

Aspen Plus Create backup (.bkp and .apmbd) versions of files from Aspen Plus 12.1 or earlier for forward compatibility and store them in a safe location. Newer Aspen Plus files contain an embedded backup file which will be read by later versions.

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

Aspen Properties Create backup (.aprbkp) versions of files from Aspen Properties 12.1 or earlier for forward compatibility and store them in a safe location. Newer Aspen Properties files contain an embedded backup file which will be read by later versions.


Upgrading Aspen Products

To upgrade any Aspen product

1 If desired or necessary (due to disk space or compatibility limitations), remove old versions of Aspen products.

2 Install the upgraded Aspen product. See "Installing Aspen Products" for specific details.

Repairing or Modifying Products For information on repairing or modifying Aspen products, see "Installing Aspen Products," for more details.

After You Upgrade When the installation process is complete, the following Aspen products require additional configuration:

If you upgraded See

Aspen Batch Process Developer

See “Updating Aspen Batch Process Developer Project Files” below.

Aspen Plus See "Re-registering CAPE-OPEN Property Packages" below.

Aspen Properties See "Re-registering CAPE-OPEN Property Packages" below.

Start the new version of the installed Aspen product and open the saved files to make sure they work properly in the new version. For instructions, see the appropriate Aspen product chapter.

After you are satisfied that the new version of the Aspen product is working correctly, uninstall the old version, if necessary.

Updating Aspen Batch Process Developer Project Files

Aspen Batch Process Developer automatically updates previously created projects to a format compatible with new versions.

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

Aspen Batch Process Developer.

2 Open an existing project.

A message box should appear indicating that the project is being converted to the new version.

The conversion process may take some time. Please be patient.

3 When the conversion is complete, verify that your projects have been successfully converted and that your simulation results are accurate.

4 Now you can uninstall the previous version of Aspen Batch Process Developer and remove your project backup files.


Re-registering CAPE-OPEN Property Packages You may need to re-register CAPE-OPEN property packages created with versions of Aspen Plus or Aspen Properties that you have uninstalled, if they are unavailable when you use the new Aspen Plus or Aspen Properties CAPE-OPEN Thermo System to import a CAPE-OPEN property package. To re-register a CAPE-OPEN property package, locate its .cota file and double-click it.


148 7 Repairing Aspen Products

7 Repairing Aspen Products

Overview Use the instructions in this section to repair corrupt data or missing elements in your AspenTech applications, databases, and INI files.

Note: If you are upgrading to a new version of a product, see "6 Adding and Upgrading Aspen Products" for instructions.

Repairing Products and Subfeatures To repair products and subfeatures




7 Repairing Aspen Products 149



3 Click the Products tab. A license requirement dialog box appears.

4 Click OK.




5 Click Next. The License Configuration Type dialog box appears.





7 Do the following:



click Next. The License Servers dialog box appears.





9 After the Licenses list is populated with all licenses found, click Next.

10 Click Products | Aspen Engineering; then click Install.


The AspenTech Upgrade Wizard appears.



The AspenTech Program Maintenance dialog box appears.

12 Click Next, accepting the Upgrade or Repair (default) option


12 Click Standard Install to uninstall the Aspen software on a single

computer or Server Install to uninstall Aspen software on a server.

13 Click Next.

The Ready to Upgrade or Repair the Program dialog box appears.


14 To complete the repair or upgrade, click Install. 15 Wait as the installation begins. The Installing Aspen Engineering

screen appears on which you can monitor the progress of the installation.



16 Click Finish.





Note: At any time before the repairs are finished, to stop the repair process and exit the installation, click Cancel.

156 8 Removing Aspen Products

8 Removing Aspen Products

Before You Remove Any Aspen Product If you are removing products in preparation for an upgrade, save files and customizations in portable formats and in safe locations. For more information, see "Chapter 6 Adding and Upgrading Aspen Products."

Overview Use the instructions in this section to remove Aspen products and their subfeatures from your system using AspenTech DVDs.

There are three methods for initiating the removal or uninstallation of AspenTech software as described below.

Removing Aspen Products Select one of the following options to remove AspenTech products.

Using the Microsoft Add/Remove Utility 1 On the Microsoft taskbar, click Start | Settings | Control Panel | Add

or Remove Programs.

The Add/Remove Programs dialog box appears with a list of all programs available for removal on the computer.

2 Select the AspenTech product to remove, such as Aspen Plus; then click Remove.

3 Click Yes to confirm removal of the feature.

The Windows Installer begins the removal.

4 When the removal is complete, on the Add/Remove Programs dialog box, click Close

8 Removing Aspen Products 157

Using the Microsoft Taskbar 1 On the Microsoft taskbar, click Start | Programs | AspenTech |

Uninstall AspenTech Software.

The AspenTech Uninstaller – Select Products dialog box appears. 2 Click the products that you want to uninstall.

or Click Select All to remove all products listed.

3 Click Uninstall.

Removal of the selected products begins.

4 When the uninstallation is complete, on the AspenTech Uninstaller – Uninstall Progress dialog box, click Close.

Using the aspenONE Removal Program

To remove products and subfeatures 1 Log on to the computer, using an account with Local Administrator

privileges.








4 Click OK.


5 Click Next.


The License Configuration Type dialog box appears.



7 Do the following:



click Next.


The License Servers dialog box appears.




9 After the Licenses list is populated with all licenses found, click Next. 10 Click Products | Aspen Engineering; then click Install.



The AspenTech Upgrade Wizard appears.


The AspenTech Program Maintenance dialog box appears.

12 On the AspenTech Program Maintenance dialog box, click Remove All.

13 Click Next.


The Remove the Program dialog box appears.

14 Click Remove.


Progress screens display showing the progress of removing the Aspen products.

When the removal is complete, the Uninstall Complete dialog box appears.

15 Click Finish.





After You Remove Aspen Products Go to the AspenTech or Aspen product directory on the machine to verify that the files have been removed. If necessary, delete any remaining folders manually.


Using Excel After Uninstalling Aspen Basic Engineering If you attempt to use Excel after uninstalling Aspen Basic Engineering, you may encounter an error. The error may report that it cannot find Aspen Basic Engineering.

If this problem occurs, do the following: 1 Start the MS Excel application.

2 Click Tools | Add-In.

3 Clear the Aspen Basic Engineering option.

Note: You must do this for each network user PC when Aspen Basic Engineering is uninstalled.


166 9 Troubleshooting

9 Troubleshooting

This chapter contains:

• Information that may help you if you have problems installing Aspen Engineering products.

• Some typical error messages.

Common Problems The following information may be useful to you if you encountered problems during installation.

Checking Installation Account Privileges This section contains information about installation account privileges.

• You must be logged on as a local administrator to install software on the PC.

Other Troubleshooting Tips 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).

• If you are installing on a server, remember that whenever you map from the user PC to the server, use the same drive letter.

• If you are performing a server installation, you must have appropriate network access between server and client machines in both directions.

9 Troubleshooting 167

Error Messages

License Errors Problem You try to run an Aspen application, and the following message appears:

LICENSE VALIDATION/CHECKOUT FAILURE FOR <Aspen Product>

Cause The licensing for the Aspen product has not been properly installed.

Solutions Reinstall the license. For instructions, see Software License Manager (SLM) Installation and Reference Guide.

Client-Server Installations This section lists error messages that you may encounter when installing the Aspen products in a client-server configuration.

The following error messages may appear if a server verification fails. Message Failed to connect to remote host via rexec. Probable cause bad

password, bad hostname, or network not installed.

Cause Either the remote or the local host cannot resolve the remote or local host name into an address. Each operating system and network protocol resolves names differently.

Solution Check to make sure that you have a valid DNS or WINS server on the network and that the client is properly configured to access it.

Troubleshooting Installation of Aspen Products Problem When installing Aspen Simulation Workbook or Aspen Utilities Planner,

the AspenTech installer gets into an infinite loop early in the installation (while installing required components before the actual product installation begins).

Cause When Aspen Simulation Workbook or Aspen Utilities Planner is installed on MS Office 2003, the patch for Microsoft KB 907417 is required before our product can be installed. This patch can fail in some cases when there is a problem with the Office installation, and when it does so it can send the AspenTech installer into an infinite loop.

Solution Visit http://support.microsoft.com/kb/907417 to download and install the patch manually. Any errors that occur during the installation will be visible. The patch may request the original Office installation media to restore damaged or missing files. If the patch still fails, consult Microsoft support.

http://support.microsoft.com/kb/907417


Troubleshooting Individual Aspen Products

Troubleshooting Aspen Adsorption, Aspen Chromatography, Aspen Custom Modeler, and Aspen Plus Dynamics Message The name specified is not recognized as an internal or external

command, operable program, or batch file.

Cause The sim_server.exe program is not at the location you specified.

Solution Repeat the verification, specifying the correct location for the sim_server.exe program.

Message The dynamic link library filename.dll could not be found in the specified

path.

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

Solution Note the name of the DLL and then use the Search tool to search your system for the missing DLL.

Message Process simserver failed to start. If you want to see more detail, click

the Details button.

Cause The User Rights Policy that allows the user to log on as a batch job has not been granted to the user shown in the error message.

Solution See "Configuring a Windows Server as an Aspen Host."

You might see these error messages on a user PC that is unable to connect to a server: Message CreateProcessAsUser: The system cannot find 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\AspenTech\AMSystemV7.1\bin\ sim_server.exe.

Troubleshooting Aspen Basic Engineering

Using Applications Immediately after an Installation If you attempt to open Aspen Basic Engineering applications immediately after installation, and have not yet shut down your PC/server, the following error message may appear:


If these messages appear: 1 Exit all Aspen Basic Engineering applications and log out of windows.

2 Log back into Windows.

3 Open your Aspen Basic Engineering applications.

Restarting the Aspen Basic Engineering Broker Service Manually If you get the following error message during the install, you will be able to start the broker manually once the installation has completed.

The most common cause of this message is an invalid password entered into the Aspen Basic Engineering Broker dialog during the install.

To start the broker service: 1 Ensure the user account password is valid and meets your company’s

current network password policy:

o Checking the user account password

With the username and password given during the Aspen Basic Engineering Broker dialog try logging into the local machine with these settings. If the user account fails to log in, it is likely that the password you have does not met your network password policy. If the account is not on the Local Machine contact your network administrator for assistance. If it is a Local User account follow the Changing the user account password procedure below.

o Changing the user account password

A Right click My Computer and select Manage, or go to Start | Settings | Control Panel | Administrative Tools | Computer Management.


B In the left pane, click Local Users and Groups followed by the Users option.

C Right-click the user used to run the Zyqad broker; then click Set Password. Enter and confirm a new password. If you have problems with this, contact your network administrator for assistance.

2 Ensure the user is a member of the Zyqad Administrator group:

Checking the user account is a Zyqad Administrator account

o Right click My Computer | Manage, or go to Start | Settings | Control Panel | Administrative Tools | Computer Management.

o In the left pane, click Local Users and Groups; then click Groups.

o Right-click ZyqadAdministrators; then select Add to Group or click ZyqadAdministrators; then go to Action | Add to Group.

o In the list of members, see if the user you want to run the Zyqad Broker is listed. If the user is not, click Add. In Look in:, click the domain the user is in: if it is a Local User account this will be the computer name. On the list, click the user; then and click Add or, alternatively in the bottom textbox, type the DOMAIN\USERACCOUNT; then click Check Names.

3 Restart the Aspen Basic Engineering Broker Service:

Restarting the Aspen Basic Engineering Broker Service o Navigate to the DataServices\Bin directory.

o Copy the following into the command prompt and press Enter (replace where necessary):

AZ131Broker.exe/regServer AZ131Broker.exe /Install /Service /AdminGroup ZyqadAdministrators /RunAs [AZ_USER] /Password [AZ_UserPass] /WorkspacesFolder [PathtoWorkspaces] /LibrariesFolder [pathtolibfolder] /ExampleWorkspace [AZ131]

where:

[AZ_USER] = The user you just added to the ZyqadAdministrators (if not a Local User account include the domain for example, domain1\user).

[AZ_UserPass] = The password given to that user account.

[PathtoWorkspaces] = The full path in "s to the workspaces folder.

[pathtolibfolder] = The full path in "s to the WorkspaceLibraries folder.

[AZ131] = Whatever you want to call the example workspace, (Note: /ExampleWorkspace [AZ131] you do not have to give this if you do not want an example workspace).

4 Checking the Aspen Basic Engineering Broker Service has started:

Checking the service has started


o Right-click My Computer | Manage, or go to Start | Settings | Control Panel | Administrative Tools | Computer Management.

o In the left pane, expand Services and Applications; then click Services.

o In the right pane look at the services to see if the service AZ131Broker has started

Troubleshooting Aspen Batch Process Developer Aspen Batch Process Developer has the following special troubleshooting procedures. Problem You cannot generate Excel reports.

Cause This can occur when certain system files shared by Aspen Batch Process Developer and Excel are not properly registered.

Solution You can avoid this problem by following the installation instructions for Excel before installing Aspen Batch Process Developer. Unfortunately, if you already have this problem, you must start over:

1 Uninstall B Aspen Batch Process Developer by following the instructions in "8 Removing Aspen Products."

2 Uninstall Microsoft Office.

3 From Windows Explorer or File Manager, manually delete the files in C:\Program Files\Common Files\Microsoft Shared\Dao. These are the system files that are not properly registered.

4 Reinstall Microsoft Office, ensuring that the Data Access option for Excel is selected.

5 Reinstall Aspen Batch Process Developer.

Problem You cannot generate Visio diagrams.

Cause This can occur if the PC has not rebooted after Aspen Batch Process Developer or Visio installation, or if Visio cannot locate the Add-ons path when Visio is launched.

Solution You can avoid the first problem by rebooting your PC after installation.

If Visio cannot locate the Add-ons path when it is launched, check the check box in the Launch Visio dialog box that appears when you launch the equipment diagram from Aspen Batch Process Developer. This resets the Visio Add-ons path and restarts Visio, which should then generate the diagram correctly.

Troubleshooting Aspen Online Deployment Aspen Online Deployment has the following special troubleshooting procedures.

Problem An online application reports that the solver failed.

Cause This can occur for a variety of reasons, from a failure to converge on a solution to a network communication failure.

Solution In order to solve the problem, you should first examine the local


application log. This log is found in the \Documents and Settings\All Users\Application Data\AspenTech\RTE\V7.1\Clouds\Online\sys directory. The log is named with the application name and has the extension .log (for example, the application HEATXN1 would have a log HEATXN1.log); there is also a backup log file that contains older log messages (for example, HEATXN1_backup.log).

Note: To avoid causing further problems with the software, make a copy of the log and examine the copy.

Examine the log file to see if there is a solver problem (for example, failure to converge) or a system problem (for example, an exception and a software procedure call stack trace).

If the failure was due to a solver problem, and the application was configured to save a snapshot when the solver fails, then you can use the Aspen Online Deployment Desktop to retrieve the application snapshot matching the failed solution; you can extract the case file from that snapshot, load it into the simulator desktop, and determine the reason that a solution could not be calculated.

If the failure was due to a system problem, and the cause of the problem is not clear from the error messages in the log, then contact AspenTech Support for assistance.

Troubleshooting Aspen Plus

Microsoft SQL Server Setup msxml6r.dll Warning When installing MS SQL Server 2005 or 2008 (including the 2005 Express edition included with aspenONE V7.1) on non-English versions of Windows XP SP3, you may get a notice saying that the installer cannot update msxml6r.dll because the file is protected.

This is a conflict between Windows XP SP3 and SQL Server. SQL Server tries to install the English version of a DLL which is included in localized version with Windows XP SP3. The localized version works with SQL Server, so this is not generally a problem.

If this message appears, click OK (or local equivalent). Microsoft has more information about this problem at http://support.microsoft.com/kb/958897.

Configuring the SQL Server for SQL Server and Windows Authentication If SQL Server or SQL Express is already installed before installing AspenTech products, it must be configured to use SQL Server and Windows authentication mode. See Configuring Microsoft SQL Server or SQL Express.

http://support.microsoft.com/kb/958897


Testing Client-Server Connectivity To test connectivity in client-server installations of Aspen Plus, verify whether the Windows client can resolve its own name and the name of the remote host running the Simulation Engine into their respective TCP/IP addresses.

1 In the MS-DOS Command Prompt window, type:

ping localhost

where:

localhost is the nodename of the local host.

2 If ping does not succeed, add the PC name and address to the domain name server (if configured) or to the local LMHOSTS file.

3 In the Command Prompt window, type:

ping remotehost

where:

remotehost is the nodename of the remote host.

4 If ping does not succeed, add the remote host name and address to the domain name server (if configured), of the local LMHOSTS file.

Error Messages

You may see these error messages on a user PC that is unable to connect to a server: Message rexec: connect:Connection refused

rexec: can't establish connection

Cause The REXECD service on the server running the simulation server software is not installed or started.

Solution On the server computer, click Start | Settings | Control Panel. Double-click Services. Ensure that REXECD is running and that Automatic startup is selected.

Message Logon Failure: unknown user name or bad password. (1326)

rexec: can't establish connection

Cause You have not provided a valid user name or password for the remote machine.

Solution Remember that unless you specify the DOMAIN name before your user name, REXEC will try to use an account defined locally on the remote machine.

Interface

You may encounter error messages when starting the Aspen Plus User Interface or when attempting to run a simulation: Message When starting the Aspen Plus User Interface this message appears:

Aspen Plus Version <version> could not open the Data Browser menu database. Data entry and results forms will not be available.

Cause The installation did not correctly build the Data Browser and Forms database file, ApwnMenu. This file, located by default in C:\Program Files \AspenTech\Aspen Plus V7.1, should always be larger than 1 MB.


Solution 1 In a Command Prompt (DOS) window, run the APFormSetup.exe utility. The default location is: C:\Program Files\AspenTech\Aspen Plus V7.1\GUI\XEQ.

2 On the Register Forms dialog box, accept all defaults; then click Next.

3 On the Register PlotWizard dialog box, accept all defaults; then click Finish.

Message The Windows client running the user interface cannot connect to the

Windows simulation engine host. The Control Panel of the Aspen Plus User Interface displays the following message: Failed to connect to remote host, probable cause bad password, bad hostname or network not installed. Socket level message is: 3000 - User A533LX\r10: Logon failure: the user has not been granted the requested logon type at this computer. (1385) Command to start xcserver was: %3:0 xcserver.exe

Cause The User Rights Policy to allow Log on as a batch job has not been granted to the user specified in the error message.

Solution See "Configuring a Windows Server as an Aspen Host."

Troubleshooting Aspen OLI


Error messages resulting from the Software License Manager’s not finding a license, and/or the OLI Security system’s not installing correctly will clearly identify which one is not functioning properly.

If the Software License Manager is not functioning correctly, the error message displayed on the Aspen OLI control panel will be as shown below:

Similarly, incorrect functioning of the OLI Security System will refer to the “OLI Security” and “OLI Engine” in the error messages. Both types of messages are shown below:


Dongle Not Attached Properly You see an error message from the OLI Security System indicating that the dongle is not attached properly. In the OLI Security Error figure above, the red text indicates “key not initialized”

Solution

Check the dongle to make sure it is attached to your computer firmly. Also, ensure that the dongle is the first one in the port if you have more than one dongle attached to this same port.


Serial Number Does Not Match with the Dongle You see an error message from the OLI Security System indicating that the serial number does not match with the dongle.

Solution: 1 On the OLI Security Error dialog box, click New Serial Number.

The OLI Security Setting message box appears. It displays your current serial number.

2 Check this number to ensure that it matches the number provided to you.

If it was typed incorrectly, then retype it in the Enter your new Serial Number field.

3 If this does not work, the error message reappears, and you will need to contact OLI for a new number.

Troubleshooting Aspen Remote Simulation Server When running Aspen Remote Simulation Server (ARSS), you may encounter the following problems.

Problem Administrator Access Privileges Required

Cause You do not have proper access privileges for running ARSS.

Solution During the installation of ARSS, you are prompted for login information (username, password, domain) that will be used when the ARSS service in starts up in Windows. The login account that you provide needs to have administrator access privileges.

Problem Possible Security Issues with the Windows Vista Firewall

Cause Your firewall is not configured for ARSS.

Solution 1 The firewall in Windows Vista must be configured to allow communication between applications on the client and server.

2 ARSS must be added to the application exceptions list in the


Windows Firewall settings.

3 The port (8086 by default) that ARSS uses for communication also needs to be added to this list.

Comments 1 If communication between client and server is still not working, then you can test whether the firewall settings are the problem by temporarily turning off the firewall on your server and see if that enables communication.

2 If you are still having trouble communicating with the ARSS on Windows Vista, then turn off User Account Control. This can be accessed in the User Accounts section of Control Panels.

Troubleshooting Aspen Simulation Workbook When running Excel with Aspen Simulation Workbook, you may encounter the following problems. Problem After installing Aspen Simulation Workbook, the Simulation Workbook

toolbars do not appear in Excel.

Cause You may have clicked the mouse on other objects while the system was trying to establish a connection.

Solution In Excel, click View | Toolbars to see a list of the toolbars. Click the Aspen Simulation Workbook Design and Aspen Simulation Workbook Run toolbars to make them active. If the toolbars are not included in the list, Excel may have disabled Aspen Simulation Workbook. Go to the next item in this table.

Problem After installing Aspen Simulation Workbook, the Simulation Workbook

Toolbars are not available in the toolbar list, and the Aspen menu does not appear on the Excel pull-down menu structure.

Cause Excel may have disabled Aspen Simulation Workbook.

Solution To check:

1 Open Excel

2 Click Help | About Microsoft Excel.

3 Click Disabled Items. If Aspen Simulation Workbook appears in the list of disabled items, remove it.

Problem After installing Aspen Simulation Workbook, the Aspen Simulation

Workbook Toolbars are not available in the toolbar list and the Aspen menu does not appear on the Excel pull-down menu structure.

Cause This usually happens if the workbook is not registered correctly and fails to load. This may have occured because Excel was open when the workbook was installed.

Solution Users (running as administrators) can manually register Aspen Simulation Workbook using the following command from a DOS window (Note: Shut down all instances of Excel before running this command):

regsvr32 "<x>:Program Files\AspenTech\ Aspen Simulation Workbook V7.1\ASWXLAddinLoader.dll"

Problem After installing Aspen Simulation Workbook, the Simulation Workbook


Toolbars are not available in the toolbar list and the Aspen menu does not appear on the Excel pull-down menu structure.

Cause Aspen Simulation Workbook Add-In may be disabled.

Solution To check:

1 Close Excel.

2 Open Aspen Simulation Workbook Add-In Manager, which is available from the AspenTech | Aspen Engineering | Aspen Simulation Workbook V7.1 Start menu.

3 If Aspen Simulation Workbook V7.1 is cleared, select the check box to the left; then click OK.

Problem After installing Aspen Simulation Workbook, the Aspen Simulation

Workbook Toolbars are not available in the toolbar list and the Aspen menu does not appear on the Excel pull-down menu structure.

Cause This usually happens if the workbook is not registered correctly and fails to load. This may have occured because Excel was open when the workbook was installed.

Solution These steps will re-register the Aspen Simulation Workbook Add-in with Excel:

1 First close all existing instances of Excel.

2 Go to Start/Programs/AspenTech/Aspen Engineering /Aspen Simulation Workbook V7.1/Aspen Simulation Workbook Add-in Manager.

3 If Aspen Simulation Workbook V7.1 is unchecked in the Aspen Simulation Workbook COM Add-in Selector - check it and click OK.

4 If Aspen Simulation Workbook V7.1 is checked - uncheck it and click OK; rerun the Aspen Simulation Workbook Add-in Manager and re-check Aspen Simulation Workbook V7.1

Troubleshooting Aspen Solubility Modeler When launching Aspen Solubility Modeler, you may encounter the following problem.

Problem While launching Aspen Solubility Modeler, you get the error message "Compile error in hidden module: This Workbook."

Cause Aspen Properties V7.1 add-in is not registered.

Solution See Configuring an Aspen Solubility Modeler Installation for complete instructions for registering the Aspen Properties V7.1 add-in in Excel.

.


180 10 Glossary

10 Glossary

The following terms and definitions are important for the installation, verification, configuration, modification, repair, and removal of Aspen Engineering products.

Term Definition

DCOM (Distributed Component Object Model)

DCOM is a Microsoft technology for distributed computing. It is an extension of Component Object Model (COM), which defines how components and their clients interact. DCOM allows one client application to remotely start a DCOM server object on another machine and invoke its methods.

Documentation DVD The DVD that contains all documentation, help files, and so on for the aspenONE release.

OLE DB A specification for a set of data access interfaces designed to enable a multitude of data stores of all types and sizes to work together seamlessly. These interfaces comprise an industry standard for data access and manipulation that can ensure consistency and interoperability in a heterogeneous environment of data and data types.

Role A grouping of logical users in order to ease the maintenance of assigning access rights. Control lists may be assigned either to individual users, or to groups to which users belong.

Role-Based Security Role-based security is used to authorize and authenticate users of AspenTech applications and data sources. By assigning users to roles that define work activities, administrators can grant security privileges to members of a given role instead of individual users.

Use Aspen Framework (AFW) Server or Aspen Local Security (ALS) to establish roles and associate users with them.

Server installation Installs files on a central server machine.

SLM The Aspen Software License Manager

Standard installation Installs all files to the local hard drive of a computer.

10 Glossary 181

182 Index

Index

A

Additional Hardware Requirements

Aspen CatRef, 32 Aspen Hydrotreater, 32 Aspen Plus CatCracker, 32 Aspen Plus Hydrocracker, 32

additional requirements Aspen Simulation Workbook, 34

Additional Requirements Aspen Batch Distillation, 24 Aspen Economic Evaluation, 25 Aspen Process Manual, 32 Basic Engineering, 23

Additional Software Requirements Aspen Custom Modeler, 25 Aspen OnLine, 26 Aspen Plus, 31 Aspen Polymers Plus, 34 Aspen Properties, 33

Aspen ACOL verifying, 113

Aspen Adsorption upgrade preparation, 144 verifying, 101

Aspen Adsorption, 21, 38, 53, 54, 74, 77, 100

Aspen Adsorption, 101 Aspen Adsorption Additional

Requirements, 23 Aspen Basic Engineering, 39, 49,

53, 54, 68, 82, 85, 171, 172 troubleshooting, 171

Aspen Basic Engineering, 23, 39 Aspen Basic Engineering, 49 Aspen Basic Engineering, 69 Aspen Basic Engineering, 78

Aspen Basic Engineering, 100 Aspen Basic Engineering

Installation Notes, 79 Aspen Basic Engineering Standard

Installation Notes, 80 Aspen Batch Distillation

configuring, 107 verifying, 107

Aspen Batch Distillation, 21, 24, 38, 100

Aspen Batch Process Developer, 100

Aspen Batch Process Developer, 21, 38, 39

Aspen Batch Process Developer Project Files

upgrading, 146 Aspen BatchSep

upgrade preparation, 144 Aspen Chromatography, 21, 26,

38, 53, 54, 74, 77, 100 upgrade preparation, 144

Aspen Custom Modeler, 21, 26, 38, 53, 54, 74, 77, 85, 100, 108, 109, 110

product requirements, 25 upgrade preparation, 144 verifying, 108 Verifying the Server Installation,

108 Aspen Distillation Synthesis, 100 Aspen Economic Evaluation, 22,

38, 39, 54, 100 product requirements, 25

Aspen Energy Analyzer, 100 Aspen Energy Analyzer, 38 Aspen Energy Analyzer, 22 Aspen Engineering DVD, 40, 55,

149, 159

Index 183

Aspen Flare System Analyzer, 22, 38, 101

Aspen HTFS+, 100 Aspen HYSYS, 22, 38, 53, 101 Aspen HYSYS Refining, 22, 39 Aspen HYSYS Refining, 101 Aspen HYSYS Upstream, 22, 38 Aspen HYSYS Upstream, 101 Aspen OLI, 91, 127, 177 Aspen OLI Interface, 90, 91, 127

verifying, 127 Aspen OLI Interface Installation

Notes, 90 Aspen Online, 78, 85

installation notes, 85 Aspen OnLine, 22, 26, 38, 49, 54,

64, 101, 113, 114, 115, 144 product requirements, 26 upgrade preparation, 144 upgrading, 144 verifying, 114

Aspen Online Deployment, 22 Aspen OTS Framework, 22 Aspen Plus, 22, 24, 25, 26, 31, 32,

34, 38, 53, 54, 73, 85, 92, 101, 109, 110, 116, 117, 119, 120, 121, 122, 123, 124, 125, 126, 127, 129, 146, 176

installing Aspen Plus Optimizer, 32

product requirements, 31 specifying a remote server,

73 upgrade preparation, 144, 145

Aspen Plus CatCracker, 22, 101 Aspen Plus CatCracker, 38 Aspen Plus Client/Server

Communication, 123 Aspen Plus Dynamics, 22, 24, 38,

53, 54, 74, 77, 101, 130 upgrade preparation, 145 verifying, 130

Aspen Plus Hydrocracker, 22, 39, 101

Aspen Plus Hydrotreater, 22, 39, 101

Aspen Plus Installation verifying, 118

Aspen Plus Optimizer, 32 Aspen Plus Reformer, 39 Aspen Plus Reformer, 22 Aspen Plus Reformer, 101 Aspen Polymers Plus, 22, 39

Aspen Process Manual, 22, 33, 53, 54, 101

installation notes, 95 Aspen Process Tools, 22, 39, 101 Aspen Properties, 22, 24, 33, 39,

53, 54, 71, 72, 73, 101, 109, 131, 133, 134, 136, 137, 146

specifying a remote server, 71

upgrade preparation, 145 verifying, 131

Aspen Reaction Modeler, 22 Aspen Remote Simulation Server,

180 Aspen Remote Simulation Service,

22 Aspen Simulation Workbook, 22,

180 product requirements, 34

Aspen Solubility Modeler, 22, 182 Aspen Utilities, 34, 35, 85, 98, 99,

141, 142

B

Basic Engineering, 21, 23 Batch Process Developer

troubleshooting, 174

C

calculation server verification without installed Fortran

compiler, 121 Change Current Destination

Location dialog box, 48, 63 Changing Product/Subfeature

Folders, 47, 62 Checking Product Specific

Requirements and Dependencies, 21

client-server installation client installation, 71

Completing the Setup, 52, 67, 157, 166

Computer Configuration Type dialog box, 46, 60, 80, 81, 83, 155, 165

configuring Aspen OnLine, 113

Configuring Aspen Basic Engineering, 106

Configuring Aspen OnLine, 113

184 Index

Configuring Aspen Products at Install Time, 49, 64

Customizing Aspen Plus Communication, 124

D

Displaying and Stopping a Process, 123

documentation, 10

E

Exchanger Design and Rating, 38

F

Feature Selection dialog box, 47, 48, 49, 62, 63, 64, 80, 81, 119, 143

Feature Selection window, 67

I

installation account privileges troubleshooting, 169

installation accounts troubleshooting, 169

installation notes Aspen Basic Engineering, 79 Aspen Online, 85 Aspen Process Manual, 95

Installation Options, 37 Installing Aspen Products, 37 Installing the FORTRAN Compiler,

125

L

License Agreement screen, 92

M

Microsoft Excel using after removing Aspen Basic

Engineering, 167

O

OLI Alliance Suite, 91 OLI HardLock Security Key, 91

P

Plate+,, 144

Polymers product requirements, 34

Product Upgrade Task Summary, 144

Program Maintenance screen, 45, 59

ProVision, 68, 81, 82

R

Ready to Install, 51, 66 Recommended Installation

Sequence, 36 Repairing or Modifying Products,

146

T

troubleshooting Aspen Basic Engineering, 171 Batch Process Developer, 174 checking installation account

privileges, 169 error messages (client-server),

170 general tips, 169

Troubleshooting Communication Problems, 124

U

upgrading Aspen Batch Process Developer

Project Files, 146 upgrading

Aspen Online, 144 Upgrading Aspen Products, 146 Using the FORTRAN Compiler with

Aspen Plus, 124

V

Valid Aspen Product Installation Options, 38

verifying Aspen ACOL, 113 Aspen Adsorption, 101 Aspen Custom Modeler, 108 Aspen OLI Interface, 127 Aspen Plus Dynamics, 130

Verifying an Aspen Chromatography Installation, 107

Index 185

Verifying an Aspen OnLine Installation, 114

W

Windows adding server accounts, 69

windows server adding Windows Server accounts, 69