Академический Документы
Профессиональный Документы
Культура Документы
Suite 11.1
Installation Manual
for Windows®
Version Number: 11.1
September 2001
Copyright (c) 2001 by Aspen Technology, Inc. All rights reserved.
AspenTech®, Aspen Engineering Suite, Aspen Plus®, Aspen Properties, Aspen B-JAC, Aspen Custom
Modeler®, Aspen Dynamics, Aspen Traflow, Aspen ADSIM, Aspen Chromatography, Aspen Water, Aspen
Utilities, Aspen Pinch, Aspen Zyqad, Aspen OnLine, Aspen Plus Online, Aspen WebModels, Batch Plus®,
Polymers Plus®, Aspen OLI, Aspen PEP Process Library, the aspen leaf logo and Plantelligence are trademarks
or registered trademarks of Aspen Technology, Inc., Cambridge, MA.
All other brand and product names are trademarks or registered trademarks of their respective companies.
This manual is intended as a guide to using AspenTech’s software. This documentation contains 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 agreement. Users are solely responsible for the proper use of the
software and the application of the results obtained.
Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the software
may be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NO
WARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS
DOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A
PARTICULAR PURPOSE.
Corporate
Aspen Technology, Inc.
Ten Canal Park
Cambridge, MA 02141-2201
USA
Phone: (617) 949-1000
Fax: (617) 949-1030
Website:http://www.aspentech.com
Division
Design, Simulation and Optimization Systems
Aspen Technology, Inc.
Ten Canal Park
Cambridge, MA 02141-2201
USA
Phone: (617) 949-1000
Fax: (617) 949-1030
Contents
Introduction 1-1
Related Documentation ....................................................................................................1-1
Training Services..............................................................................................................1-3
Technical Support ............................................................................................................1-4
Online Technical Support Center.........................................................................1-4
Phone and e-mail..................................................................................................1-5
Overview 2-1
Overview of the Aspen Engineering Suite Installation....................................................2-1
Installation CDs....................................................................................................2-1
Recommended installation sequence ...................................................................2-2
Plantelligence & Enterprise Optimization............................................................2-3
AES System Requirements ..............................................................................................2-3
Hardware requirements ........................................................................................2-3
Software requirements..........................................................................................2-4
AES Product Requirements..............................................................................................2-5
Aspen ADSIM......................................................................................................2-5
Aspen B-JAC .......................................................................................................2-5
Aspen Chromatography........................................................................................2-5
Aspen Custom Modeler........................................................................................2-5
Aspen Icarus.........................................................................................................2-5
Aspen OLI ............................................................................................................2-5
Aspen OnLine ......................................................................................................2-6
Aspen Plus Online................................................................................................2-6
Aspen PEP Process Library..................................................................................2-6
Aspen Pinch..........................................................................................................2-6
Aspen Plus............................................................................................................2-7
Aspen Properties ..................................................................................................2-7
Aspen Split ...........................................................................................................2-7
Aspen Traflow......................................................................................................2-7
Aspen Utilities......................................................................................................2-7
Aspen WebModels Author...................................................................................2-8
Aspen WebModels Server....................................................................................2-8
Aspen Zyqad ........................................................................................................2-9
Batch Plus.............................................................................................................2-9
Polymers Plus.....................................................................................................2-10
Troubleshooting 9-1
Common Problems...........................................................................................................9-1
Checking Installation Account Privileges ............................................................9-1
Other Troubleshooting Tips .................................................................................9-1
Problem Accessing Help ......................................................................................9-2
Error Messages.................................................................................................................9-3
Client-Server Installations....................................................................................9-3
Index 33-1
Introduction
Related Documentation
In addition to this document, a number of other documents are
provided to help users learn and use the applications of the Aspen
Engineering® Suite. All manuals are available in PDF format.
Aspen License Manager • Aspen License Manager Version 3.0 Installation and Reference
Manual for Windows Platforms
Training Services
AspenTech offers a comprehensive training program for
AspenTech product users:
• Instructor-led, hands-on courses are regularly scheduled at
AspenTech Training Centers throughout the world; they can
also be presented at customer sites.
• Self-paced Computer Based Training packages are available
for some product ranges.
For the latest worldwide training schedules, pricing and course
descriptions, recent Training News and contact/registration
information, see the AspenTech website:
http://support.aspentech.com/training
Technical Support
Online Technical AspenTech customers with a valid license and software
Support Center maintenance agreement can register to access the Online
Technical Support Center at:
http://support.aspentech.com/
This web support site allows you to:
• Access current product documentation
• Search for tech tips, solutions and frequently asked questions
(FAQs)
• Search for and download application examples
• Submit and track technical issues
• Send suggestions
• Review lists of known limitations
Phone and e-mail Customer support is also available by phone for customers with a
current support contract for this product. The hours listed are in
local time.
Brazil Office
Hours: 09:00 – 17:00
Phone: 000-814-550-4084 (toll free to US)
55-11-5012-0321
Fax: 55-11-5012-4442
E-Mail: tecnosp@aspentech.com
Singapore Office
Hours: 09:00 – 17:30
Phone: 65-395-39-00
Fax: 65-395-39-50
E-Mail: atasupport@aspentech.com
Overview
AspenTech CD CD Color
Application/Product CDs:
Aspen Engineering Suite Blue
Aspen Manufacturing Suite Yellow
Aspen eSupply Chain Suite Orange
Business Process Templates (BPT) Green
Install desired
software from CD Y*
Plantelligence & Yes Install the
Enterprise AFW Server
Optimization?
Install desired
software from CD Z*
No
Windows 2000 On the desktop, click Start | Settings | Control Panel and double-
click System.
The General tab of System Properties dialog box displays the
installed version of Windows 2000 and any service pack.
Note: Do not change the default privileges on the folders that are
created by the installation process. If you change these privileges,
your installation may not work correctly.
Standard Installs all files to the local hard drive of a computer. The
computer may be a:
• Stand-alone or networked user PC with enough space and
power on the local drive to store and run the installed AES
products.
• File server in a lite-client configuration.
• Client PC in a client-server configuration.
You can install any AES product this way.
For detailed installation instructions, see Chapter 3, Standard
Installation.
Lite Client Installs almost all files on a file server. When a user runs the
application, files are copied into memory on the user
User PC/
PC/workstation and the program runs on the client.
Workstation
For detailed installation instructions, see Chapter 4, Lite Client
Installation.
Client-Server Although all files reside on the computer where they are used,
processing is split between the user PCs (clients) and a central
User PC/
server. Products supporting this configuration usually put the
Workstation computing intensive or main data processing activities on the
server machine.
For detailed installation instructions, see Chapter 5, Client -
Server Installation.
Aspen ADSIM X X X
Aspen B-JAC X X
Aspen Chromatography X X X
Aspen Custom Modeler X X X
Aspen Dynamics X X X
Aspen Icarus X X
Aspen OLI X
Aspen OnLine X X
Aspen PEP Process Library X
Aspen Pinch X X
Aspen Plus X X X
Aspen Plus Online X X
Aspen Properties X X X
Aspen Split X
Aspen Traflow X X
Aspen Utilities X X
Aspen Water X X X
Aspen WebModels Author X
Aspen WebModels Server X
Aspen Zyqad X X X
Batch Plus X X
Polymers Plus X X X
Standard Installation
Overview
The Standard installation option installs all AES product
components on a single computer.
The following flowchart summarizes the standard installation
process:
Choose Destination 7 On the Choose Destination Location dialog box, specify the
Location root destination directory under which all AspenTech products
for this software version will be installed on this computer. The
default is:
C:\Program Files\AspenTech
Specifying the root To specify a different AspenTech destination, click the Browse
destination directory for button. In the dialog box select or specify the pathname and
Aspen product click Open. If a dialog box appears prompting you for
installations permission to create the folder, click Yes.
Note: This dialog box, prompting you for the AspenTech folder
location only appears the first time you install AspenTech products
for this version on this computer.
Select Products / 9 On the Select Products dialog box, select the AES products
Subcomponents you want to install on the computer. Then click Next to
continue.
Icon Description
The key icon indicates that the product or subcomponent
is licensed.
The lock icon indicates that the product or subcomponent
is restricted and can only be installed if an ALM server
provides evidence of licensing.
The OS icon indicates that the product or subcomponent
is not applicable to the operating system of this computer
The drive icon indicates that the product is already
installed on this computer.
Changing product / As you select the products to install, the space available on the
subcomponent folders target drive and the space required to install the products are
displayed at the bottom of the dialog box.
For a selected product, you can change the default destination
location of its product directory. Additionally, you can change
the default destination location of product subcomponents.
To change the destination location of a selected AES product
or subcomponent, click Change Folders and select the new
location.
Configure AES Depending on the products you are installing, additional dialog
product components boxes appear, prompting you for product-specific information.
If you are installing You are prompted for
Select Program 10 On the Select Program Folder dialog box, select or name a
Folder Program Folder to contain the program icons for the installed
products, and click Next to continue.
Forcing the installation of Use this option for subsequent installations of AES products to
core components ensure that all core components are installed. When this option is
unchecked, any existing core components are not reinstalled. For
more information, see Chapter 7, Adding or Reinstalling
Components.
Setup Needs Next After the common core components are installed, the Setup
Disk Needs the Next Disk dialog box appears, prompting you to
insert CD2, the Product CD for Aspen Engineering Suite.
13 Remove CD1 and insert CD2 into the drive and then click OK
on the dialog box.
Setup Complete 14 When the Setup Complete dialog box appears, select Yes, I
want to restart my computer now.
15 Remove the CD from the drive, and then click Finish on the
dialog box.
16 On the AspenTech Software Setup dialog box, click OK.
The system shuts down and reboots.
Select Aspen The first time you install an AspenTech product on this computer,
Framework Server the Select Aspen Framework Server dialog box appears,
prompting to you to choose one of three options.
Specifying the Aspen To use AES products as Plantelligence & Enterprise Optimization
Framework Server solutions:
1 Specify the name of the Aspen Framework Server.
2 Do one of the following:
• If all Aspen Framework components are located on a single
server, click Next.
• If any Aspen Framework components are located on a
different server, click the Advanced button and go to
step 3.
3 In the Framework Server Advanced Configuration dialog
box, select Advanced Settings and enter the following
information:
BPE Server Name The name of the server on which
Business Process Explorer is installed.
Selecting the AFW If you select the I will select an Aspen Framework Server later
Server later option, you will be prompted for the name of the server with the
first use of a Plantelligence & Enterprise Optimization solution.
To specify the Aspen Framework Server after completing the
installation, see “Specifying or Changing the AFW Server” on
page 3-16.
Choosing not to use an If you select the I do not wish to use an Aspen Framework
AFW Server Server option, the products will run as they did prior to
Plantelligence & Enterprise Optimization.
Note: Select this option if you are installing only one product.
Running the products as If you select Yes, the Select Aspen Framework Server dialog
Plantelligence/Enterprise box appears, prompting you for the name of the AFW server. For
Optimization solutions instructions, see “Select Aspen Framework Server” on page 3-12.
Overview
In a lite-client installation of AES products, most of a product’s
software is installed on a file server. When using the product,
User PC
files are copied into memory on the networked user PC and the
program runs locally on the PC.
The advantages of this type of installation are:
• The amount of software physically installed on the user PC is
reduced.
File
Server • When you perform upgrades or any other maintenance
operations, you need only do this on the file server.
However, this type of installation can result in slower software
performance.
Choose Destination 8 On the Choose Destination Location dialog box, specify the
Location root destination directory under which all AspenTech products
for this software version will be installed on this computer. The
default is:
C:\Program Files\AspenTech
Specifying the root To specify a different AspenTech destination, click the Browse
destination directory for button. In the dialog box select or specify the pathname and
Aspen product click Open. If a dialog box appears prompting you for
installations permission to create the folder, click Yes.
Note: This dialog box, prompting you for the AspenTech folder
location only appears the first time you install AspenTech products
for this version on this computer.
Select Products / 10 On the Select Products dialog box, select the AES products
Subcomponents you want to install on the computer.
Icon Description
The key icon indicates that the product or subcomponent
is licensed.
The lock icon indicates that the product or subcomponent
is restricted and can only be installed if an ALM server
provides evidence of licensing.
The OS icon indicates that the product or subcomponent is
not applicable to the operating system of this computer.
The drive icon indicates that the product is already
installed on this computer.
Selecting To change the subcomponents installed with a product, select
Subcomponents the product and click Select Subcomponents. Select or clear
the appropriate checkboxes in the Select Subcomponents
dialog box and then click OK to return to the Select Products
dialog box.
Changing Product folders As you select the products to install, the space available on the
target drive and the space required to install the products are
displayed at the bottom of the dialog box.
Depending on the product selected, you can change either its
Working Folders directory location or its top-level product
directory location. Additionally, you may be able to change the
default location of specific subcomponents.
Note the following product restrictions:
Product Restriction
Aspen ADSIM Specify the common root destination directory under which
Aspen Chromatography any if these products must be located. For example:
Aspen Custom Modeler K:\AspenTech\
Aspen Dynamics
Aspen Traflow
Aspen Water
Aspen B-JAC Specify the location of the product folder, for example:
K:\AspenTech\Aspen B-JAC 11.1
Aspen Plus • Specify the location of the user interface, for example:
K:\AspenTech\Aspen Plus 11.1\GUI\xeq\apwn.exe
• Specify the location of the simulation engine, for example:
K:\AspenTech\Aspen Plus 11.1\Engine\xeq\aspen.exe
Aspen Properties • Specify the location of the user interface, for example:
K:\AspenTech\Aspen Properties 11.1\
xeq\AspenProperties.exe
• Specify the location of the calculation engine, for example:
K:\AspenTech\Aspen Properties 11.1\
Engine\xeq\Apmain.exe
Aspen Zyqad • Specify the location of the product folder, for example:
K:\AspenTech\Aspen Zyqad 11.1
• An additional dialog box prompts for the Aspen Zyqad
Broker host and port connection.
• (Optional)Specify the location of the ProVision
configuration and schema definition files.
For details, see Chapter 28, Aspen Zyqad.
Installation Summary 14 On the Summary dialog box, review the summary of your
selected installation options and do the following:
• To modify any selected option, click the Back button to the
appropriate dialog box and make the changes.
• To complete the installation, click the Start Installing
button.
Forcing the installation of Use this option for subsequent installations of AES products to
core components ensure that all core components are installed. When this option is
unchecked, any existing core components are not reinstalled. For
more information, see Chapter 7, Adding or Reinstalling
Components.
Setup Complete The installation takes a few minutes, depending on the speed of
the machine and the CD drive.
15 When the Setup Complete dialog box appears, select Yes, I
want to restart my computer now. Then click Finish.
16 On the AspenTech Software Setup dialog box, click OK.
The system shuts down and reboots.
Overview
A client-server installation of AES products takes advantage of
User PC/
Workstation
using a powerful server computer to perform calculations and
various data-processing activities.
The Server installation option enables you to install AES
simulation and calculation engines on a server computer for use
by user PCs running AES product software.
Server running
WndowsNT or A alternate option exists which provides both the performance
Windows 2000
advantages of a client-server installation and the space-saving
advantages of a lite-client installation. For more information see
“Combining Server and Lite Client Install Options” on page 5-26.
Aspen ADSIM
Aspen Chromatography
Aspen Custom Modeler
Aspen Dynamics
Aspen Water
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.
Choose Destination 7 On the Choose Destination Location dialog box, specify the
Location root destination directory under which all AspenTech products
for this software version will be installed on this computer. The
default is:
C:\Program Files\AspenTech
Specifying the root To specify a different AspenTech destination, click the Browse
destination directory for button. In the dialog box select or specify the pathname and
Aspen product click Open. If a dialog box appears prompting you for
installations permission to create the folder, click Yes.
Note: This dialog box, prompting you for the AspenTech folder
location only appears the first time you install AspenTech products
for this version on this computer.
Select Products / 9 On the Select Products dialog box, select the AES products
Subcomponents you want to install on the computer. Then click Next to
continue.
Icon Description
The key icon indicates that the product or subcomponent
is licensed.
The lock icon indicates that the product or subcomponent
is restricted and can only be installed if an ALM server
provides evidence of licensing.
The OS icon indicates that the product or subcomponent
is not applicable to the operating system of this computer
The drive icon indicates that the product is already
installed on this computer.
Changing the destination As you select the products to install, the space available on the
location of a component target drive and the space required to install the products are
displayed at the bottom of the dialog box.
Configure AES Depending on the products you are installing, additional dialog
product components boxes appear, prompting you for product-specific information.
If you are installing You are prompted for
Select Program 11 On the Select Program Folder dialog box, select or name a
Folder Program Folder to contain the program icons for the installed
products, and click Next to continue.
Forcing the installation of Use this option for subsequent installations of AES products to
core components ensure that all core components are installed. When this option is
unchecked, any existing core components are not reinstalled. For
more information, see Chapter 7, Adding or Reinstalling
Components.
Setup Complete The installation takes a few minutes, depending on the speed of
the machine and the CD drive.
14 When the Setup Complete dialog box appears, select Yes, I
want to restart my computer now. Then click Finish.
15 On the AspenTech Software Setup dialog box, click OK.
The system shuts down and reboots.
Creating Local Group and To create local group and user accounts:
User Accounts
1 On the desktop click Start | Programs | Administrative Tools
(Common) | User Manager.
The User Manager window appears.
2 On the menu bar click User | New Local Group.
3 On the New Local Group dialog box, enter a Group Name for
the local group, for example, Local1. Then click OK.
4 On the menu bar click User | New User.
The New User dialog box appears.
5 Enter the following information:
Username The name of the new user, for example,
Local Aspen User.
Password The password based on your local
Confirm Password security policy.
Select the Password Never Expires option.
6 Click the Groups button.
The Group Memberships dialog box appears:
7 In the Not member of list, select the name of the group you
created, for example, Local1, and click Add to add the group to
the Member of list. Then click OK.
8 Click OK to close the New User dialog box
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 | Programs | Administrative Tools
(Common) | User Manager.
2 On the menu bar click Policies | User Rights.
The User Rights Policy dialog box appears.
3 Select the Show Advanced User Rights option at the bottom
of the dialog box.
4 From the Right list, select Log on as a Batch Job , and click
Add.
The Add Users and Groups dialog box appears.
5 For List Names From, select your local NT server.
6 In the Names list, select the users and groups you created and
click Add.
Tip: To view all user names for the selected domain, click Show
Users.
Granting server access To grant access to the Windows NT server for domain users or
for domain/trusted trusted domain users:
domain users
1 On the desktop click Start | Programs | Administrative Tools
(Common) | User Manager.
2 On the menu bar click Policies | User Rights.
The User Rights Policy dialog box appears.
3 Select the Show Advanced User Rights option at the bottom
of the dialog box.
Creating Local Group and To create local group and user accounts:
User Accounts
1 On the desktop click Start | Settings |Control Panel |
Administrative Tools | Computer Management.
The Computer Management console appears.
2 In the console tree expand System Tools | Local users &
Groups and click Groups.
3 On the Action menu click New Group.
The New Group dialog box appears.
4 Enter a Group Name for the local group, for example, Local1.
Then click Create.
5 In the console tree, select Users and on the Action menu, click
New User.
The New User dialog box appears.
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, and then double-click
Local Security Policy.
3 Double-click Security Settings, double-click Local Policies,
and then double-click User Rights Assignment.
4 Double-click the user right Logon as a Batch Job.
5 Click Add, and then click the accounts to which you want to
assign the right.
6 Click OK and then click OK again.
7 Confirm that the changes have taken effect locally by closing
the Local Security Policy window and then re-opening it.
The newly assigned rights should appear under the Effective
Settings columns.
Optimizing Network Note: The procedure in this section applies only to Windows NT
Applications Server machines.
Aspen Zyqad If you are performing a server installation, you do not need to
restart the computer. However, you need to check that the Aspen
Zyqad Broker and Server services have started.
To check the Broker and Server services:
1 On the desktop,
Windows NT: Click Start | Settings | Control Panel. Double click the
Services to display the Services dialog box.
• 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 | Aspen
Engineering Suite | Aspen Plus 11.1 | Aspen Plus Interface.
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.
Aspen ADSIM To specify a remote server from a user PC running any of the
Aspen Chromatography Aspen Modeler System products:
Aspen Custom Modeler
Aspen Dynamics
1 On the desktop click Start | Programs | AspenTech | Aspen
Aspen Utilities Engineering Suite | AES product 11.1 | AES product.
Aspen Water 2 On the menu bar click Tools | Server Configuration.
3 In the Server Configurations dialog box, click Add.
• Debugger Name
If you intend to debug the server process of the simulator,
enter the command used to invoke the debugger.
• User Name
Specify the user name of the user under whom the
simulation server software will run on the remote server.
You must supply a name.
7 Click OK.
8 In the Servers dialog box, select the name of the server you
just added as the Host Computer.
For example:
Name of host
you added
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:
Name of remote
configuration
Aspen ADSIM If you encounter any problems running any of these AES products,
Aspen Chromatography you can ensure that REXEC is working correctly on the user PC.
Aspen Custom Modeler To do this:
Aspen Dynamics
Aspen Utilities At the command prompt on the user PC, type:
Aspen Water 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 11.1\bin,
• Domain is aspen.com
• UserName is Fred
you would type:
rexec Blue C:\Program Files\AspenTech\AMSystem
11.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 11.1) built on Apr 18
2001 at 17:40:23
If you encounter any other messages, see Chapter 9,
Troubleshooting.
This chapter describes the procedures you should follow if you are
upgrading previously installed Aspen Engineering Suite products.
Overview
The following flowchart summarizes the process of upgrading
AES products:
Complete steps in Save files in portable If desired or
Before You Upgrade formats and in safe necessary, uninstall
locations old version
Note: When you remove the old version of the AES product, the
product folder and all of its contents will be deleted.
Product Upgrade The following table summarizes the tasks you should perform to
Task Summary prepare for an Aspen software upgrade. An asterisk (*) indicates
the recommendation that you keep the previous version on your
machine until you are satisfied with the installation of the new
version, if there is sufficient disk space.
Before you
upgrade Do this
Aspen Plus Create backup (.bkp and .apmbd) file versions for
forward compatibility and store them in a safe
location.
Note: You must remove the old version of Aspen OnLine before
you install the new version.
Batch Plus Project Batch Plus automatically updates previously created projects to a
Files format compatible with new versions.
To convert existing projects to a format compatible with the new
version of Batch Plus:
1 After you install the new version of Batch Plus, start Batch
Plus.
2 Open an existing project.
A message box should appear indicating that the project 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 Batch Plus and
remove your project backup files.
Adding or Reinstalling
Components
Overview
The following flowchart summarizes the process of
adding/reinstalling AES products:
Complete steps in Review the pre- Back up
Before You installation customizations
Add/Reinstall AES requirements
Components
Note: If this option is not selected and the installer detects any
existing core components, those core components are not
reinstalled.
Overview
The following flowchart summarizes the process of removing AES
products:
Complete steps in In preparation for upgrade, save
Before You remove files/customizations in portable
AES products formats and in safe location
Note: You must do this for each network user PC when Aspen
Zyqad is uninstalled.
If you install both Aspen Plus and Aspen Properties on the same
Re-registering CAPE- computer, the second program installed registers the location of
OPEN components CAPE-OPEN Thermo components.
If you uninstall the second program, the remaining program may
not be able to access these components.
If this is the case, run the CAPE-OPEN Registry Fixup Utility to
re-register the CAPE-OPEN components so that the remaining
program can access them.
To re-register the CAPE-OPEN components:
1 Click Start | Programs | AspenTech | Aspen Engineering
Suite | (remaining product) | CAPE-OPEN Registry Fixup
Utility.
A dialog box appears, displaying the location of the remaining
product’s Engine.
2 Click OK to continue.
Troubleshooting
Common Problems
The following information may be useful to you if you
encountered problems installing.
Checking Installation This section contains information about installation account
Account Privileges privileges.
• You must be logged on as a local administrator to install
software on the PC
• Your path must include the Windows NT directory (\WINNT)
and the Windows system32 directory (\WINNT\system32).
• You must have the TEMP and TMP environment variables set
to valid directories.
• Before installation, your Winnt\System32 folder must have
Full privileges.
• After installation, do not change the privileges on your working
folder. This is the place where your work files are stored and
therefore people must have Full or Change privileges for this
location.
Solutions 1 Delete all *.gid, *.fts, and *.ftg files from the
Help directories.
2 Do one of the following:
• Ensure that all users have read-only access
to the file server. In this case, Windows
Help will write the index files to a
directory on the local computer, such as
WINNT\Help under Windows NT 4.0.
or
• Ensure that all lite-client machines use the
same drive letter for the shared drive on the
file server. This may require lite-client
reconfiguration, or reinstallation of
applications if they were installed to use
different drive letters on different
computers.
Aspen ADSIM
Aspen B-JAC
Aspen Chromatography
Verifying Aspen To verify an Aspen Custom Modeler installation that uses Aspen
Custom Modeler with Properties:
Aspen Properties 1 In Aspen Plus create an Aspen Plus document (.apw) file in a
test folder.
2 In Aspen Custom Modeler run the InitializeSimulation
script. This script:
• Fixes the feed compositions, flows, temperatures, and
pressures in each of the feed streams. Notice also that we
use a stream model.
• Initializes the temperature, liquid and vapor flows in the
absorber. The specabsorber script fixes the pressure and
temperature in the absorber, and frees the duty for each
stage.
• Runs the simulation. A steady-state run at this point is at a
fixed temperature of 50°C. This simulation converges very
quickly, and shows the power of using simplified properties
and initialization.
• Switches the simulation to rigorous properties and an
adiabatic duty for each tray.
• Runs a steady-state simulation again.
• Switches the specifications of the absorber to dynamic
specifications, where tray coefficients are used to calculate
the pressure, and the vapor and liquid product flows are
fixed.
Creating the Aspen Plus To create the Aspen Plus document file:
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
11.1\Examples\Absorber
Aspen Dynamics
Aspen Icarus
Windows 2000 Due to read/write access issues for certain Windows 2000
configurations, we recommend installing Aspen Icarus products in
a directory other than Program Files.
Aspen OLI
Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online • 17-1
The DCOM associated with Aspen OnLine runs as a user. You
Specifying a DCOM
must specify the DCOM user account.
user account
When the following dialog box appears, enter the
Domain\Username and password for the account. This account
must have administrative privileges.
Enabling CIM-IO After you select the Aspen OnLine on the Select Products dialog
Server Security box, you are prompted to enable CIM-IO Server security.
To enable the CIM-IO server security feature:
1 When the CIM-IO Core Security Settings dialog box
appears, select the Enable Security checkbox and click Next.
17-2 • Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1
2 Enter the Domain\Username and password for the account
which will run the security service. This account must have
local administrator access.
Configuring CIM-IO for The CIM-IO component for Aspen OnLine must be configured to
Aspen OnLine communicate with the source of plant data.
Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online • 17-3
Adding Services To add services to the Windows NT server computer:
1 In Windows Notepad (or other text editor), open the services
file. The default location is:
C:\winnt\system32\drivers\etc\services
2 Insert the following two lines so that all services are 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
Specifying Logical To specify the Logical Devices used by CIM-IO in its logical
Devices 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.
17-4 • Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1
Configuring DCOM The Aspen OnLine 11.1 installation program should perform
DCOM configuration for the user. However, if for some reason
DCOM is not configured completely, or if the password for the
DCOM user account changes, follow these instructions.
To configure DCOM:
1 On the desktop click the Start | Run. In the Run dialog box,
Enter DCOMCNFG and click OK.
The Distributed COM Configuration Properties window
appears.
2 On the Applications tab select APOServer.TheAPOServer
and click the Properties button.
The APOServer.TheAPOServerProperties dialog box
appears.
3 On General tab, select None for Authentication Level.
4 Display the Location tab and ensure that only Run
Application on this Computer is selected.
5 Display the Security tab. Make sure Use Custom Access
Permissions is selected and click its Edit button.
These names should be granted Allow Access type of access:
• Everyone
• Interactive
• System
When finished, click OK.
6 On the Security tab make sure Use Custom Launch
Permissions is checked and click its Edit button.
The System account should be granted Allow Launch type of
access
When finished, click OK.
7 On the Security tab make sure Use Custom Configure
Permissions is checked and click its Edit button.
<Computer name>\administrators should be granted Full
Control type of access.
When finished, click OK.
8 Display the Identity tab. Select This user and enter the
Domain\UserName and password of an account with
administrative privilege.
Note: when this account has a new password, update the new
password here.
Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online • 17-5
9 Click Apply and then click OK to close the
APOServer.TheAPOServer Properties dialog box.
10 On the Distributed COM Configuration Properties dialog
box, display the Default Properties tab, and select the
following options:
• Enable Distributed COM on this computer
• Impersonate for the Default Impersonation Level
Note: Aspen OnLine does not use the “Provide additional security
for reference tracking” option.
Note: Aspen OnLine does not use the “Provide additional security
for reference tracking” option.
17-6 • Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1
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 AES products on the server machine
3 Verify Aspen OnLine on the server and client machines.
Verifying Plant Data To verify plant data access on the server machine, follow the
Access instructions in “The CIM-IO Test Utility” section of the Aspen
OnLine User Guide.
Verifying AES Aspen OnLine 11.1 can drive Aspen Plus models and models from
products Aspen Custom Modeler and related products such as Aspen
Utilities.
• If Aspen OnLine 11.1 is used to drive Aspen Plus models,
verify that Aspen Plus 11.1 has been correctly installed on the
server machine.
• If Aspen OnLine 11.1 is used to drive Aspen Custom Modeler
and related product models, verify that version 11.1 of the
corresponding Aspen Custom Modeler products have been
installed properly.
Verifying Aspen
OnLine
To verify Aspen Online on the server machine:
Server machine 1 Go to the installed Aspen OnLine 11.1 product folder and copy
the subfolder, AOLSample, to a location under one of the local
drives on the server machine.
2 On the desktop click Start | Programs | AspenTech | Aspen
Engineering Suite | Aspen OnLine 11.1 | 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
Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online • 17-7
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 exit the Project Manager.
8 On the desktop click Start | Programs | AspenTech | Aspen
Engineering Suite | Aspen OnLine 11.1 | Project Client
GUI.
The Aspen OnLine window appears.
9 On the Aspen OnLine Startup dialog box,
• Specify the Server name (step 3)
• Select AOLSample as project name.
Click OK.
10 In the Steady-state detection frame click Load. After the
program is loaded, click Start.
In the frame on the right, do the same to start the Aspen
OnLine engine.
Aspen OnLine is running.
17-8 • Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1
Aspen Plus Online Installation Notes
Aspen Plus Online has two subcomponents:
• Aspen Plus Online User Interface
• Aspen Plus Online Engine Standard
The Aspen Plus Online Engine requires the Aspen Plus 11.1
Simulation Engine.
Aspen Plus Online supports a client-server configuration.
Configuring the The apol111serv service must be defined on both the host server
apol111serv Service machine and on the client PC before the Aspen Plus Online GUI
can communicate with the host problem. The installation of Aspen
Plus Online provides a default setup for this service, using port
number 11008.
To change the default setup for the apol111serv service:
1 Select a TCT/IP port number for Aspen Plus Online.
2 Define the apol111serv service on the client PC.
3 Define the apol111serv service on the Host computer.
Determining the TCP/IP The Aspen Plus Online GUI requires a dedicated TCP/IP port
port number number to communicate with the Host machine. Both the client
and Host use the same port. This port number can not be used for
any other service.
1 On the client PC, locate the services file.
The default location is:
Windows NT C:\WINNT\system32\drivers\etc
Windows 2000 C:\system32\drivers\etc
2 Select a port number for the Aspen Plus Online GUI, for
example 60003.
3 Check the services file to make sure that the selected port
number is not being used.
4 On the Host machine, locate its services file and verify that the
selected port number is not being used.
Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online • 17-9
Defining the apol111serv To define the apol111serv service for the Aspen Plus Online GUI
service on the client PC and the Host machine:
1 Locate the services file.
2 Add the following line to the file:
Note: Make sure the last line of the services file is a blank line.
Aspen Plus Online When Aspen Plus Online is installed on Windows NT or Windows
Startup 2000, it creates a new service, called “Aspen Plus Online 11.1,”
which performs all startup activities.
By default this service is set up for automatic startup. To change
the Aspen Plus Online service, open Services in the Control Panel.
To disable the automatic start up, change the service to manual
startup.
17-10 • Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1
C H A P T E R 18
Installation Manual_Aspen Engineering Suite 11.1 Aspen PEP Process Library • 18-1
Troubleshooting Aspen PEP Process
Library
When running Aspen PEP Process Library, you many encounter
the following problem.
18-2 • Aspen PEP Process Library Installation Manual_Aspen Engineering Suite 11.1
C H A P T E R 19
Aspen Pinch
5 When Aspen Pinch starts, open the Crude Unit B case in the
Case Manager window.
8 Verify that these numbers are the same for your installation.
Aspen Plus
Installation Notes
All installations of this version of Aspen Plus require the core
Properties System for Aspen Plus (APrSystem) subcomponent.
When you install Aspen Plus, the separately licensed Aspen Plus
Optimizer is installed automatically.
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 To install the Aspen Plus simulation engine on a Windows server:
Simulation Engine on 1 On the server machine, perform a Server installation of Aspen
the server Plus, following the instructions in Chapter 5, Client-Server
Installation.
2 When the Select Products dialog box appears, select Aspen
Plus 11.1 and click the Select Subcomponents button.
Step 2: Verify the After you install the Aspen Plus Simulation Engine on the server,
Simulation Engine verify the installation.
installation on the To verify the installation of the Aspen Plus Simulation Engine:
server
1 On the server machine open Windows Explorer and go to the
following Aspen Plus directory:
..\AspenTech\Aspen Plus 11.1\Engine\XEQ
2 Copy the file INSTPROB.INP to this directory:
..\AspenTech\Working Folders\Aspen Plus 11.1.
3 On the desktop click Start | Programs | AspenTech | Aspen
Engineering Suite | Aspen Plus 11.1 | 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 simple /getridof
This command runs the problem and deletes the working files.
Any errors are reported in the simple.out file, located in
..\AspenTech\Working Folders/Aspen Plus 11.1.
If there are problems running the simulation, see
“Troubleshooting Aspen Plus” on page 20-12.
Step 3: Set up user After you complete the installation of the AES server components
access to the on the server machine, you must configure the server as an AES
calculation server host. Each user who will connect to the Windows NT/2000 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.
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.
Customizing Aspen The mm.ini file determines how the User Interface communicates
Plus Communication 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 11.1\GUI\xeq
Changing timeout You can adjust the following variables, contained in each section
variables 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 Default
name How long to wait value
connect_timeout During the login process for the 90 seconds
xcserver.exe process to connect to the
client again
rcmnd_timeout For a response from the xcserver.exe 90 seconds
process
inter_timeout For a response from the apmain.exe 90 seconds
process
Troubleshooting You can use the mm.ini file to debug communication problems
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 11.1\GUI\xeq.
The mm.ini file contains this line:
debug OFF
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 NT works fine.
4 The FORTRAN source file can be compiled using the
ASPCOMP command. The user 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.
Verifying the After you install the FORTRAN compiler and TelnetD Server on
Installation of the the server, you need to verify that they are operating properly. The
FORTRAN Compiler 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
11.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 | Aspen Engineering Suite | Aspen Plus 11.1 |
Aspen Plus Interface.
5 Open the file DRSEX14.BKP, located in the ..\Aspen Plus
11.1\GUI\XMP directory.
The Connect to Engine dialog box appears.
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.
Client-Server
Installation Problems Problem Client installations to a Novell file server fail when
you try to run calculations on a local PC.
Cause The Novell file server is truncating long directory
names.
Solution Move simulation engine directories to a location that
does not contain any directory names with more than 8
characters or any special characters.
Error Messages You might see these error messages on a user PC that is unable to
connect to a server:
rexec:connect:Connection refused
Message
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 the Start | Settings |
Control Panel. Double-click Services, make sure that
REXECD is running and that Automatic startup is
selected.
Aspen Plus User You may encounter error messages when starting the Aspen Plus
Interface User Interface or when attempting to run a simulation:
Aspen Properties
Installation Notes
All installations of this version of Aspen Properties require the
core Properties System for Aspen Properties (APrSystem)
subcomponent.
Configuring IIS for After you install Aspen Properties on the web server, you must
Aspen WebProperties configure the Internet Information Server (IIS) for WebProperties.
To configure IIS for Aspen WebProperties:
1 On your desktop click Start | Programs | Windows NT 4.0
Option Pack | Microsoft Internet Information Server |
Internet Service Manager.
2 In the console tree expand Internet Information Server |
<your_IIS_server_name>
3 Right click Default Web Site and click New | Virtual
Directory on the menu.
Note: If you do not see an account name, you are accessing the
page anonymously and may not be able to modify IIS metabase
properties.
Configuring DCOM on To configure DCOM on the web server for Aspen WebProperties:
the web server 1 On the web server machine locate the
SetupWebPropDCOM.reg file in the ..\Aspen Properties
11.1\WebProperties\InstallRoot directory.
2 Double click on SetupWebPropDCOM.reg to register Aspen
Properties 11.1 as a remote server on the machine running
Aspen WebProperties.
3 On the desktop of the web server machine, click Start |Run. In
the dialog box enter dcomcnfg and click OK.
The Distributed COM Configuration Properties dialog box
appears.
4 On the Applications tab select Aspen Properties Document
in the list and click Properties.
Note: You can specify additional security and setup options on the
Distributed COM Configuration Properties dialog box, using
the Default Properties and Default Security tabs.
Configuring DCOM on Setting the correct permission levels on the machine running
the Aspen Properties Aspen Properties 11.1 is necessary for DCOM to work properly. If
machine a user is not authorized to use the system, there will be server
errors when Aspen Properties 11.1 is accessed via DCOM. The
DCOM specifications are specific to your location and authorized
users.
To configure DCOM on the machine running Aspen Properties:
1 On the desktop of the Aspen Properties machine click Start
|Run. In the dialog box enter dcomcnfg and click OK.
The Distributed COM Configuration Properties dialog box
appears.
2 On the Applications tab select Aspen Properties Document
in the list and click Properties to set any custom security for
this application (Security tab of the Properties dialog box).
3 Display the Default Properties tab and do the following:
• Select the Enable distributed COM on this computer
checkbox.
• Select the appropriate Default Authentication Level.
4 Display the Default Security tab and edit the Default Access
Permissions and Default Launch Permissions to give
permission to all the users of the application.
Note: If a user is not authorized at this level, then the user will not
be able to use Aspen WebProperties.
Aspen Split
Installation Notes
When you install Aspen Split 11.1:
• Ensure that standard version of Aspen Plus 11.1, which
includes the core Properties System component, the Aspen Plus
Simulation Engine, and the Aspen Plus User Interface, is
installed and accessible.
or
• Install Aspen Plus simultaneously with Aspen Split.
Aspen Split includes two subcomponents:
Subcomponent Description
4 On the Set Base Directory dialog box, locate and select the
Sample Problems folder in the Aspen Split installation. Then
click OK.
If necessary, select the appropriate drive from the Drives list.
The Aspen Split window appears and displays the Case
Manager window.
Use the set of tabs at the bottom of the window to enter data.
8 Click the Components tab and select All Components. Ensure
that these are the components:
• Comp1 = METHANOL
• Comp2 = ACETONE
• Comp3 = CHLF
9 Click the Properties tab and select these Physical Property
Models:
• VLE property model = WILSON
• LLE property model = UNIFAC
The number of phases for the model is 2.
10 Click the Ternary Diagram tab to calculate and display the
ternary diagram with residue curves.
Aspen Traflow
Aspen Utilities
Note: If you have not already done so, restart Windows to activate
the changes made to your configuration during the installation.
Microsoft Excel Interface To set up the Microsoft Excel interface to Aspen Utilities:
1 Start Microsoft Excel.
2 Open demo.xls located in the Aspen Utilities working folder.
The default location is:
C:\Program Files\AspenTech\Working Folders\Aspen
Utilities 11.1
Aspen Water
Creating the Aspen Before you insert the AES Application/Product Software CD into
WebModels Server the CD-ROM drive of the server machine, you must create a
user account WebModels Server user account. This account
• Must be the same user account on your web server and all
calculation servers.
• Will be used only by the Aspen WebModels system.
This user account must have administrative privileges on these
computers and cannot be a local account. The user account
privileges are critical for the various Aspen WebModels
components to function correctly.
Creating the After you click the Start Installing button on the Summary
WebModels Database dialog box, the Create SQL Server Aspen Framework
Database dialog box appears.
To create the WebModels database:
1 On the Create SQL Server Aspen Framework Database
dialog box, enter the login and database details for the
WebModels database as follows:
Login • If you have administrator privileges, select
Details Windows NT.
• If you select the SQL Server authentication,
enter the Administrator Login ID and
password.
Configuring VSS
After the Aspen WebModels Server is installed:
• Ensure that the account whose identity is to be used for the
MTS packages and DCOM identities is set up with VSS.
• Add WebModels Author users.
Adding WebModels The users of WebModels Author create, maintain, and publish the
Author users web models. These users require access permissions to the
WebModels library through VSS.
Note: When you add a user to the VSS database, leave the
password field blank.
5 Click OK.
6 Repeat steps 3 through 5 for each user you want to add.
Configuring security To configure security for the WebModels roles and applications:
for the WebModels 1 On the desktop click Start | Programs | AspenTech | AFW
roles and Security Manager.
applications
2 In the console tree expand AFW Security Manager and click
Applications.
3 In the details pane right-click WebModels and click
Properties on the menu.
4 Under Application Properties, give Read, Write, and
Execute permissions to both the Author and Administrator
roles.
5 In the console tree, expand AFW Security Manager |
Applications and click WebModels.
6 In the details pane right-click AspenPlus and click Properties
on the menu.
7 Under Application Properties, give Read, Write and Execute
permissions to both the Author and Administrator roles.
Creating additional You may create as many roles as your site requires. For example,
roles you may wish to create a role specifically for those users who will
be running a designated collection of models.
For more information creating AFW roles, see the:
• Aspen Framework Installation Manual
• Business Process Explorer Help File
Note: You must configure security for each addition role that you
create.
Configuring the The Server displays information related to the application servers
Application Servers used with WebModels. Use the Server to:
• Add a new application server to the WebModels configuration.
• Edit a server’s information.
• Delete an application server from the WebModels
configuration
Configuring the The Role displays information related to the Aspen Framework
WebModels Roles (AFW) roles used with Aspen WebModels. The WebModels roles
that you set up in “Configuring Aspen Framework” on page 27-5
must be added here.
Adding a Role To add a role to the WebModels configuration:
1 In the console tree click the Role folder to display its details.
Property Value
To Do this
Property Value
Prioritizing Server The Server Order enables you to specify the order in which the
Resources WebModels Server prioritizes server resources for a selected
application.
For example, if “Server_1” is faster than “Server_2,” you might
want to put “Server_1” at the top of the list. WebModels will
attempt to use this server first, when using the associated
application to try to run a simulation. Should that server be
unavailable, WebModels will attempt to use the next server in the
list until it succeeds in securing resources to run the requested
simulation.
To prioritize server resources for a given application:
1 In the console tree click the Server Order folder to display its
details.
2 In the details pane select the application in the left column.
3 Select the server in the right column and click the Up and
Down arrows to move the server to the desired priority for the
selected application.
Property Value
To Do this
Configuring MTS
To specify the identity of middle-tier in-process components:
1 On the desktop,
Windows NT: Click Start | Programs | Windows NT 4.0 Option Pack |
Microsoft Transaction Server | Transaction Server
Explorer .
Windows 2000: Click Start | Programs | Administrative Tools | Component
Services.
2In the console tree,
Windows NT: Expand Microsoft Transaction Server | Computers | My
Computer | Packages Installed .
Windows 2000: Expand Component Services | Computers | My Computer |
Packages Installed .
3 Right-click the eObject package and click Properties on the
shortcut menu.
4 In the eObject Properties dialog box, click the Identity tab
and select This user.
Note: If the Identity tab is disabled, click the Activation tab, select
Server Package and then click the Identity tab again.
Stopping and Starting The Load Balancer Operations enables you to start and stop the
the LoadBalancer LoadBalancer, as well as to view the status of the currently loaded
calculators.
Verify the location of The WebModels LoadBalancer and the Enterprise Objects must be
Mutex and Pdh DLLs able to locate these files:
• Mutex.dll
• Pdh.dll
Verify that these files are either located in the SYSTEM32
directory or the location is specified in the Path system variable.
Ensure that DLLs and This is the default location of the Aspen WebModels DLL and
EXEs are properly EXE files:
registered …\wwwroot\AspenTech\WebModels\Bin
To register the WebModels server DLL and EXE files, run the
register.bat file located in the WebModels\Bin\Setup
directory.
Confirm the WebModels Use Internet Information Manager (Windows NT) or Internet
authentication Information Services (Windows 2000) to confirm the WebModels
authentication.
To confirm the WebModels authentication:
1 In the console tree expand Internet Information Server |
your-WebModels-server | Default Web Site.
2 Right-click the WebModels folder and click Properties on the
menu.
3 In the WebModels Properties dialog box, click the Directory
Security tab.
4 In the Anonymous Access and Authentication Control section,
click the Edit button.
5 In the Authentication Methods dialog box, ensure that this is
the only checkbox selected:
Windows NT: Windows NT Challenge/Response
Windows 2000: Integrated Windows authentication
All other checkboxes should remain unchecked.
6 Click OK to close the Authentication Methods dialog box.
7 Click OK to close the WebModels Properties dialog box.
Verify the WebModels Use Internet Information Manager (Windows NT) or Internet
Virtual Directory Information Services (Windows 2000) to confirm the WebModels
authentication by verifying that:
• default.asp is the enabled WebModels default document.
Check the WebModels Use the Registry Editor to ensure that the WebModels registry
registry keys are set up correctly.
To check the WebModels registry:
1 Run Regedit.
2 Expand the Registry Editor tree as follows:
HKEY_LOCAL_MACHINE | SOFTWARE | AspenTech |
WebModels
3 Ensure that these keys are listed with the correct values:
Key Value
Check the WebModels Use the SQL Enterprise Manager to ensure that the SQL database
SQL database and tables for WebModels are set up correctly.
To check the SQL database and tables for WebModels:
1 In the console tree expand Microsoft SQL Servers | SQL
Server Group | your-WebModels-server | Databases |
WebModels.
2 Click Tables to display the details.
3 Ensure that the WebModels database contains these required
User tables:
Application
DeletedItems
LibraryModel
Properties
Roles
Server
UserInfo
4 If the tables are missing, run webmodels_tables.sql, located in
the …\wwwroot\Aspentech\WebModels\Bin\Setup
directory.
Check MTS for Use MTS Explorer (Windows NT) or Component Services
WebModels (Windows 2000) to ensure that the eObject package identity for
Aspen WebModels is correct and to verify that these components
exist:
• AspenWebModelsASP.LibraryManager
• AspenTech.AFW.POManager
To check the eObject package for Aspen WebModels:
1 In the console tree,
Windows NT: Expand Microsoft Transaction Server | Computers | My
Computer | Packages Installed .
Windows 2000: Expand Component Services | Computers | My Computer |
Packages Installed .
2 Right-click the eObject package and click Properties on the
shortcut menu.
3 In the eObject Properties dialog box, click the Identity tab
and check the Account information to ensure that the identity
is correct; and if necessary, change it.
Check the DCOM These items must have the correct WebModels identity:
settings for the
• LB_QM.lb_entry
WebModels Server
components • LBAssist1.CUtil
• WMAP.AP
To check and, if necessary, change the identity on these items, run
dcomcnfg. For instructions see “Configuring WebModels Server
components under DCOM” on page 27-17
Check the DCOM These items must have the correct WebModels identity:
settings for the
• Apploader1.CleanupWorkFolder
calculation servers
• WatchDog.IWatchDogNotify
To check and, if necessary, change the identity on these items, run
dcomcnfg. For instructions, see “Configuring remote calculation
servers under DCOM” on page 27-18.
Aspen Zyqad
Component/Subcomponent Description
Aspen Zyqad Server
Server Core server component incorporating
data management, knowledge base
rules.
Broker Client/server communications.
Action Item ü
1 Decide which Product Components of Aspen Zyqad
are required.
• Client-Server Installations: Not all components are
required for each user. Decide where to install the
Aspen Zyqad NT Server and Aspen Zyqad Client
components (recommended on at least one machine on
the network), and decide which other machines will
host the Aspen Zyqad Client applications.
• The Sample Projects subcomponent requires the
installation of the Server subcomponent.
• If the Development Application component is
required, a licensed copy of Harlequin LispWorks
version 4.1 and LispWorks patchkit 20 must be
installed before you install Aspen Zyqad.
• The Sample Projects Library Source Files component
requires the installation of the Development
Application component.
• Customizing requires the installation of the
Development Application and the Excel Datasheet
Definer components
• If the Excel Datasheet Definer component is required,
a licensed copy of MS Excel 2000, must be installed
before you install Aspen Zyqad.
2 Confirm that System Requirements are met.
Ensure that the machine has adequate space for the application
installation. See “AES System Requirements” on page 2-3.
3 Confirm the installation accounts privileges.
Windows 2000: Must have the System Administrator privilege,
“Act as part of the operating system.”
4 Confirm license.
Aspen Zyqad must be installed in accordance with your license
agreement. This version of Aspen Zyqad supports ALM 3.0.
Specifying the Zyqad During a standard installation, the Aspen Zyqad Standard
Broker connection Installation dialog box appears and prompts you for the
Broker connection:
• Host, which is the name of the computer containing the
Aspen Zyqad server software that the clients will access.
• Port, which is the identity of the port on which the Host is
listening.
For example:
Specifying the location of If you select the Development Application subcomponent, the
LispWorks executable Aspen Zyqad Installation dialog box prompts you for the
location of the installed Harlequin LispWorks executable.
Editing the net.cfg file The net.cfg file defines the configuration information required
by both the Aspen Zyqad broker and Aspen Zyqad server. The
name of this file is specified as a command line option to the
broker and the server.
Configuring the The Aspen Zyqad broker uses the workgroups.cfg file, which
Workgroups.cfg file defines the workgroups (or projects).
For instructions on configuring the workgroups.cfg file, see the
Aspen Zyqad Workgroup Components Reference Manual.
Defining the Symbol The symbol library folder contains the available symbols and
Library Folder as a labels for the workgroup. To ensure that these symbols and labels
Network Share are accessible to all the workgroup clients, you must define the
folder as a network share.
You define the location of the symbol library folder using the
SYMBOLPATH value in the workgroup configuration file.
Selecting a Sample 4 In the Open Workgroup dialog box, select the sample
Workgroup workgroup, az111, from the list and click OK.
A dialog box appears, displaying the application version
number and a message that the workgroup is about to open.
5 Click OK to start the workgroup.
Selecting a Diagram 6 From the Aspen Zyqad menu bar, click File ¦ Diagram.
The Diagrams dialog box appears.
7 Click New and select New Diagram from the list. Then click
Open.
The Aspen Zyqad Question dialog box appears:
8 Enter a name for the new diagram and click OK.
Batch Plus
Specifying the Batch After you select Batch Plus and any other AES products for
Plus server installation, the Batch Plus Server Wizard appears, enabling you
to establish a connection to a Batch Plus server in a client-server
installation configuration.
You can specify the server connection information at this time or
after you complete the installation. For instructions on connecting
to a server after installation, see “Connecting to a Server after
Installation,” on page 29-5.
Creating the Batch After you select Batch Plus and any other AES products for
Plus Server database installation, the Server Selection dialog box appears, enabling you
tables and records to create the database tables and records.
To create the database tables and records for Batch Plus:
1 When the Server Selection dialog box appears, enter the
Server Name and select the Server Type.
5 Click OK.
The BPSync Logon dialog box appears.
6 If there are no users in the database, click Cancel and continue
with the next step.
Otherwise, enter your user name, password, and domain and
click OK to start using the database.
7 If there are no users in the database, on the BPSync menu bar,
click Admin | Roles and enter users to the Administrators
role.
The database is set up, and you can add roles and users, and start
using the database.
5 Click OK.
The BPSync Logon dialog box appears.
6 If there are no users in the database, click Cancel and continue
with the next step.
Otherwise, enter your user name, password, and domain and
click OK to start using the database.
7 If there are no users in the database, on the BPSync menu bar,
click Admin | Roles and enter users to the Administrators
role.
The database is set up, and you can add roles and users, and start
using the database.
Polymers Plus
Installation Notes
The standard, lite client, and client-server installations of
Polymers Plus require the corresponding installation of Aspen Plus
on the same machine. Aspen Plus 11.1 must be installed prior to or
simultaneously with Polymers Plus 11.1.
Installation Manual_Aspen Engineering Suite 11.1 Appendix A – HASP Key Licensing • 31-1
2 From your server load the NetHASP driver, using this
command:
Load HASPSERV –SAPTOFILE
3 Copy the HASPADR.DAT and NEWHADDR.DAT files from
SYS:SYSTEM to the installed Aspen B-JAC folder, XEQ.
TCP/IP The program prompts you for the server IP address. To load the
NetHASP network driver, execute this command:
NHSRVWNT.EXE -TCPIP
31-2 • Appendix A – HASP Key Licensing Installation Manual_Aspen Engineering Suite 11.1
Appendix B – Using the DETHERM
Database
Installation Manual_Aspen Engineering Suite 11.1 Appendix B – Using the DETHERM Database • 32-1
Configuration Location
4 Click OK.
You may return to this utility later to change the DETHERM
configuration.
32-2 • Appendix B – Using the DETHERM Database Installation Manual_Aspen Engineering Suite 11.1
Index
A
verifying client-server communication,
Aspen ADSIM 5-24
installation configuration options, 2-15 verifying the installation, 12-1
product requirements, 2-4
Aspen Custom Modeler
server installation verification, 5-16
installation configuration options, 2-15
specifying a remote server, 5-20
product requirements, 2-4
troubleshooting (client-server), 9-3
related documentation, 1-2
upgrade preparation, 6-3
server installation verification, 5-16
verifying client-server communication,
specifying a remote server, 5-20
5-24
troubleshooting (client-server), 9-3
verifying the installation, 10-1
upgrade preparation, 6-2
verifying the installation with Aspen
verifying client-server communication,
Properties, 10-2
5-24
Aspen B-JAC verifying the installation, 13-1
changing licensing after installation, 11-2 verifying the installation with Aspen
HASP key license configuration, 31-1 Properties, 13-2
installation configuration options, 2-15
Aspen Dynamics
product requirements, 2-4
installation configuration options, 2-15
related documentation, 1-1
related documentation, 1-2
upgrade preparation, 6-3
server installation verification, 5-16
verifying the installation, 11-1
specifying a remote server, 5-20
Aspen Chromatography troubleshooting (client-server), 9-3
installation configuration options, 2-15 upgrade preparation, 6-2
product requirements, 2-4 verifying client-server communication,
related documentation, 1-1 5-24
server installation verification, 5-16 verifying the installation, 14-1
specifying a remote server, 5-20
Aspen Engineering Suite
troubleshooting (client-server), 9-3
adding components, 7-2
upgrade preparation, 6-3
client-server installation, 5-1
installation configuration options, 2-14
C hardware requirements
server, 2-3
CAPE-OPEN
HASP key license
re-registering components, 8-3
using, 31-1
CIM-IO Server security
enabling for Aspen OnLine, 17-2
CITRIX
Aspen Zyqad configuration, 28-13