You are on page 1of 32

Aspen Configured Applications (CAPs)

Installation Guide

Version Number: V7.3


March 2011
Copyright (c) 2001-2011 by Aspen Technology, Inc. All rights reserved.
Aspen CAPs, Aspen Refinery Scheduler, Aspen Orion, Aspen PIMS, Aspen Retail Fleet Planner & Scheduler
(Retail), Aspen Retail, Aspen Supply Chain Operations Scheduler (SC Ops Scheduler), Aspen Supply Chain Planner
(SC Planner), Aspen Inventory Management & Operations Scheduling (IMOS), Aspen SCM, Aspen Framework,
Aspen SLM tools, Aspen SLM, Aspen Role-Based Visualization, Aspen Event Management, Aspen Integration
Infrastructure, Aspen Information Management, Aspen Batch, Aspen Production Management, Aspen Advanced
Process Control, Aspen Supply Chain Analytics, Aspen Collaborative Forecasting (CF), aspenONE, the aspen leaf
logo and Plantelligence and Enterprise Optimization 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 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.
Aspen Technology, Inc.
200 Wheeler Road
Burlington, MA 01803-5501
USA
Phone: (781) 221-6400
Website: http://www.aspentech.com

Contents
1 Introduction .........................................................................................................5
About this Installation Guide..............................................................................5
Related Documentation .....................................................................................5
aspenONE Overview .........................................................................................6
System Requirements.......................................................................................7
Technical Support ............................................................................................9
2 Installing Aspen CAPs ........................................................................................11
Before You Install........................................................................................... 11
Installing Aspen CAPs ..................................................................................... 12
Upgrading Aspen CAPs .................................................................................... 18
3 Uninstalling Aspen CAPs.....................................................................................25
Uninstalling Aspen CAPs Using the Microsoft Add/Remove Utility .......................... 25
Uninstalling Aspen CAPs Using the Microsoft Taskbar .......................................... 26
Uninstalling Aspen CAPs Using the aspenONE Method ......................................... 26
Index ....................................................................................................................31

Contents

iii

iv

Contents

1 Introduction

This chapter provides an introduction to Aspen Configured Application (CAPs)


installation. It includes the following topics:

About this Installation Guide

Related Documentation

aspenONE Overview

System Requirements

Technical Support

About this Installation Guide


This document describes how to install Configured Applications (CAPs) on
Windows.
Note: This document does not include the installation of AspenTech industry
features.

Audience
This installation guide is intended for anyone who needs to install CAPs,
including system administrators, application developers, and end users.

Related Documentation
In addition to this document, AspenTech provides the following
documentation for Aspen CAPs:

1 Introduction

Aspen CAPs Release Notes

Help for each CAP

Implementation Guide for each CAP

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.

Packaging
Included in your package from AspenTech, you will find the following items
that you will need prior to installation:

Letter notifying you which products are licensed

Package of DVDs (see Installation DVDs below)

License file (only if a dongle has also been shipped to you)

Instructions on how to run the License Utility (if a dongle is not used)

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 product installation process, but can be used
separately to browse the documentation and install PDF documentation.

aspenONE Product DVDs includes a number of DVDs that contain the


installations for Aspen products. For a complete description of the
contents of those DVDs, refer to the aspenONE Deployment Guide.

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.

1 Introduction

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.
For Aspen CAPs, the following documents are available from the aspenONE
Documentation DVD:
Aspen CAPs Release Notes
Aspen CAPs Installation Guide (this document)
The following documents, which are not available from the aspenONE
Documentation DVD, are installed on your computer when you install each
CAP:
Help
Implementation Guide

System Requirements
This section describes the system requirements for the Aspen CAPs.

1 Introduction

Required Hardware
The hardware requirements for installing CAPs are the same as the
requirements for Aspen SCM. For details, see the Aspen SCM Installation
Guide.

Required Software
The CAPs require the following software:

Shared libraries. Each CAP depends on several shared libraries. By default,


these shared libraries are installed to the following folder:
C:\Program Files\AspenTech\Aspen CAPs\Shared Libraries
If you install the shared libraries to a location other than the default
folder, you may need to modify the $TCASES table. For details, see the
CAP ReadMe file.

Aspen SCM Release V7.3. Each CAP has different requirements for SCM
modules. For details, see the Implementation Guide for each CAP.

Web browser (required for CAPs Help) Microsoft Internet Explorer 5.0 or
Netscape Navigator 4.7 or higher.

Required Software Settings


In order to display Aspen SCMs user interface elements correctly, you must
specify certain settings in SCM and in Microsoft Windows.
Examples:

SCM dialogs are developed to fit into the space provided by a Workspace
frame. Dialog display can be truncated if the appropriate settings, such as
screen resolution, are not in effect.

Dialog buttons and labels are affected by font size and mono- vs. variablespacing.

Required Windows Settings

Screen resolution The CAPs support the following screen resolutions:


o

1024 x 768

1280 x 1024

1400 x 1050

1600 x 1200

For details on changing screen resolutions, see the Help for your CAP.

Windows Task Bar Height set to a maximum of one row (instead of


multiple rows (Note - this is the Windows default setting), or the Auto
Hide option is active.

Required Aspen SCM Settings

SCM window Maximized

Label Fonts MS Sans Serif, 8 pt.

Editor Window Header Font MS Sans Serif, 8 pt.

1 Introduction

Editor Window Cell Font Lucida Console, 8 pt.

Editor Window Panel/String Table Cell/Header Font Lucida Console, 8 pt.

Editor Window Background Color Microsoft Gray

To change the label fonts:


1

In SCM, click Options | System | Window Attributes.

Click the Label Fonts button for Graph Windows, Planning Board
Windows, Presentation Graphics (Chart) Windows, and Dialog Windows

Set the font to MS Sans Serif, 8 pt.

To change the Editor Window fonts:


1

In SCM, click Options | System | Editors | Font.

Set Header font to MS Sans Serif, 8 pt.

Set Cell font to Lucida Console, 8 pt.

Set Panel/String Table Cell/Header font to Lucida Console, 8 pt.

To change the Editor Window background color:


1

In SCM, click Options | System | Editors | Color.

Set the Background color to Microsoft Gray.

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

Search for and download service packs and product updates

Submit and track technical issues

Send suggestions

Report product defects

Review lists of known deficiencies and defects

Registered users can also subscribe to our Technical Support e-Bulletins.


These e-Bulletins 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-todate contact information is available at the AspenTech Support Center at
http://support.aspentech.com.

1 Introduction

10

1 Introduction

2 Installing Aspen CAPs

This chapter explains how to install the current versions of the Aspen CAPs. It
includes the following topics:

Before You Install

Installing Aspen CAPs

Upgrading Aspen CAPs

Notes:

This installation assumes that you do not currently have Aspen CAPs
installed on your computer.
All AspenTech products are offered on a 3-disc DVD set. The AspenTech
Installer can guide you through the installation of a single product as well
the installation of a group of products that are integrated to provide
industry solutions. This manual describes the installation of Aspen CAPs
within the AspenTech Supply Chain family of products.

Before You Install


Before installing Aspen CAPs, you must perform the following pre-installation
tasks:

Install Aspen SCM. For details, see the Aspen SCM Installation Guide.

Install and configure Software License Manager (SLM). Enter license keys.
For details, see the Software License Manager (SLM) Installation and
Reference Guide.

Close all running applications.


Note: If you leave external applications running during the setup process,
any files that are in use may be damaged.

Read these instructions thoroughly.

Select a directory to contain the CAPs case files. The default location for
Aspen CAPs is:
o

Windows Vista and Windows 2008 Server C:\Users\Public\Documents\AspenTech\Aspen CAPS\

Windows XP and Windows 2003 Server C:\Documents and


Settings\All Users\Documents\AspenTech\Aspen CAPS

2 Installing Aspen CAPs

11

During the installation process, you can select a different location if


desired.

Select a directory to contain the CAPs shared libraries. The default location
for Aspen CAPs shared libraries is:
C:\Program Files\AspenTech\Aspen CAPs\Shared Libraries
During the installation process, you can select a different location if
desired.

Select a program folder.

Installing Aspen CAPs


To install Aspen CAPs:
1

Insert the Aspen Supply Chain Family V7.3 installation DVD into your DVD
drive.
Note: If your company has set up Aspen Supply Chain Family software for
installation from a network-accessible drive, you can install CAPs over the
network without a DVD. Locate the directory that contains the Aspen
Supply Chain Family installation kit and double-click setup.exe. For
additional details, see the aspenONE Deployment Guide.
Aspen Supply Chain Family includes the following products: Aspen
Collaborative Forecasting (CF), Aspen CAPs, Aspen SCM, Aspen Supply
Chain Connect, and Aspen Supply Chain Analytics.
The AspenTech Installation Browser dialog box appears, and a popup
window informs you that you need to configure license information.
If this dialog box does not appear a few seconds after inserting a DVD,
browse to the DVD drive and launch setup.exe in the DVD folder.

12

2 Installing Aspen CAPs

Click OK. The AspenTech Installation Browser Welcome dialog box


appears.

Click Next. The AspenTech Installation Browser License


Configuration Type dialog box appears.

Select the desired method of product licensing:


o

License Server Select this option if you want to use only license
files located on a network license server.

Standalone License File Select this option if you want to use only
license files that are located on your local machine.

Both Select this option if you want to use license files that are
located on a network license server and license files that are located
on your local machine.

Important: Do not select the None option when installing Aspen Supply
Chain Family products.
5

Click Next.

2 Installing Aspen CAPs

13

If you selected Standalone License File or Both on the AspenTech


Installation Browser License Configuration Type dialog box, the
AspenTech Installation Browser License Files dialog box appears.

The License Filename field displays a list of license files. If the desired
license file name does not appear in the list, click Add License File and
navigate to the location of the license file.
Click Next.

14

If you selected License Server or Both on the AspenTech Installation


Browser License Configuration Types dialog box, the AspenTech
Installation Browser License Servers dialog box appears.

2 Installing Aspen CAPs

This dialog box displays a list of license servers. If the desired license
server name does not appear in the list, click Add Server and navigate to
the location of the license server.
Click Next. The AspenTech Installation Browser Determining
Licensed Products dialog box appears.

10 Wait while the installation program reads your license files and determines
the products for which you have valid licenses. When this process is
complete, the installation program displays a Completed message and
indicates the number of licenses found.
The Licenses field displays a list of products for which you have valid
licenses.
11 Click Next. The AspenTech Installation Browser dialog box appears
again.

2 Installing Aspen CAPs

15

12 Select the Products tab.


13 Expand DVD 2 Manufacturing & Supply Chain, and then select
Aspen Chemical Supply Chain.
14 Click Install to begin the installation process. The Welcome dialog box
appears after a few seconds.
15 Click Next. The Program Maintenance dialog box appears.

16 Select Modify.
17 Click Next. The License Agreement dialog box appears.
18 Click Yes, I accept the terms in the license agreement.

16

2 Installing Aspen CAPs

19 Click Next. The Computer Configuration Type dialog box appears


20 Select a computer configuration type, either Standard Install or Server
Install.
Note: For all Aspen Supply Chain Family products, the Standard Install
and Server Install options are identical.
21 The Feature Selection dialog box appears, displaying all products within
the Aspen Supply Chain family of products for which you are licensed.

22 Select the CAPs you want to install.


o

The

Click + to view subfeatures. Click to hide the subfeatures.

Click the down arrow to display a menu that allows you to choose the
method of installation:
Click
Click

icon indicates that a feature is not currently installed.

to install the feature.


to install the feature and all its subfeatures.

The Feature Selection dialog box displays the location where the
software will be installed. The default destination is:
C:\Program Files\AspenTech\Aspen CAPS\
Note: The folder for Demand Manager, Distribution Scheduler, Inventory
Planner, Plant Scheduler, and Supply Chain Planner, which contains
introductory files and CASE files, is always created at the following
location:
o

Windows Vista And Windows 2008 Server


C:\Users\Public\Documents\AspenTech\Aspen CAPS\

2 Installing Aspen CAPs

17

Windows XP And Windows 2003 Server


C:\Documents and Settings\All Users\Documents\AspenTech\Aspen
CAPS\
You can accept the default destination or click Change to install Aspen
CAPs in a different folder.

Note: Common features are always installed in the following folder,


regardless of the destination location selected:
Program files\Common Files\AspenTech Shared
23 Review the Installation Summary and confirm that all information is
accurate. If so, click Install to start the Aspen CAPs installation.
To make changes, click the Back button and make changes on the
applicable dialog box. To stop and exit the installation, click Cancel.
The Installing Aspen Supply Chain Suite dialog boxes display, allowing
you to monitor the progress of the installation.
Note: If any other programs are running, the Close Applications dialog
box prompts you to close running applications before proceeding with the
installation.
24 When the Wizard Completed dialog box appears, click Finish.

Upgrading Aspen CAPs


This section describes how to upgrade from a prior version of Aspen CAPs.

To upgrade Aspen CAPs:


1

Insert the Aspen Supply Chain Family V7.3 installation DVD into your DVD
drive. The AspenTech Installer automatically detects any AspenTech
software that is installed on your computer.
Note: If your company has set up Aspen Supply Chain Family software for
installation from a network-accessible drive, you can install CAPs over the
network without a DVD. Locate the directory that contains the Aspen
Supply Chain Family installation kit and double-click setup.exe. For
additional details, see the aspenONE Deployment Guide.
Aspen Supply Chain Family includes the following products: Aspen
Collaborative Forecasting (CF), Aspen CAPs, Aspen SCM, Aspen Supply
Chain Connect, and Aspen Supply Chain Analytics.
The AspenTech Installation Browser dialog box appears, and a popup
window informs you that you need to configure license information.
If this dialog box does not appear a few seconds after inserting a DVD,
browse to the DVD drive and launch setup.exe in the DVD folder.

18

2 Installing Aspen CAPs

Click OK. The AspenTech Installation Browser Welcome dialog box


appears.

Click Next. The AspenTech Installation Browser License


Configuration Type dialog box appears.

Select the desired method of product licensing:


o

License Server Select this option if you want to use only license
files located on a network license server.

Standalone License File Select this option if you want to use only
license files that are located on your local machine.

2 Installing Aspen CAPs

19

Both Select this option if you want to use license files that are
located on a network license server and license files that are located
on your local machine.

Important: Do not select the None option when installing Aspen Supply
Chain Family products.
5

Click Next.

If you selected Standalone License File or Both on the AspenTech


Installation Browser License Configuration Type dialog box, the
AspenTech Installation Browser License Files dialog box appears.

The License Filename field displays a list of license files. If the desired
license file name does not appear in the list, click Add License File and
navigate to the location of the license file.
Click Next.

20

2 Installing Aspen CAPs

If you selected License Server or Both on the AspenTech Installation


Browser License Configuration Types dialog box, the AspenTech
Installation Browser License Servers dialog box appears.

This dialog box displays a list of license servers. If the desired license
server name does not appear in the list, click Add Server and navigate to
the location of the license server.
Click Next. The AspenTech Installation Browser Determining
Licensed Products dialog box appears.

2 Installing Aspen CAPs

21

10 Wait while the installation program reads your license files and determines
the products for which you have valid licenses. When this process is
complete, the installation program displays a Completed message and
indicates the number of licenses found.
The Licenses field displays a list of products for which you have valid
licenses.
11 Click Next. The AspenTech Installation Browser dialog box appears
again.

12 Select the Products tab.


13 Expand DVD 2 Manufacturing & Supply Chain, and then select
Aspen Chemical Supply Chain.
14 Click Install to begin the installation process. The Welcome dialog box
appears after a few seconds.
15 Click Next. The Program Maintenance dialog box appears.

22

2 Installing Aspen CAPs

16 Select Modify and click Next. The remainder of the installation is the
same as installing products for the first time. See Installing Aspen
CAPs on page 12.

2 Installing Aspen CAPs

23

24

2 Installing Aspen CAPs

3 Uninstalling Aspen CAPs

This chapter describes how to uninstall Aspen CAPs.


There are three methods for uninstalling AspenTech software as described
below:
1

Microsoft Add/Remove Utility

Microsoft Taskbar

aspenONE Removal

Uninstalling Aspen CAPs Using


the Microsoft Add/Remove
Utility
To uninstall features and subfeatures using the Microsoft
Add/Remove utility:
1

On the Microsoft taskbar, select 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.

Select the desired CAPs and click Remove.

Click Yes to confirm removal of the feature. The Windows Installer begins
the removal.

When the removal is complete, click Close on the Add/Remove


Programs dialog box.

3 Uninstalling Aspen CAPs

25

Uninstalling Aspen CAPs Using


the Microsoft Taskbar
To uninstall features and subfeatures using the Microsoft
taskbar:
1

On the Microsoft taskbar, select Start | Programs | AspenTech |


Uninstall AspenTech Software. The AspenTech Uninstaller Select
Products dialog box appears.

Select the desired CAPs or click Select All to remove all features listed.

Click Uninstall. Removal of the selected features begins.

When the uninstallation is complete, click Close on the AspenTech


Uninstaller Uninstall Progress dialog box.

Uninstalling Aspen CAPs Using


the aspenONE Method
To uninstall features and subfeatures using the aspenONE
removal method:
1

Insert the Aspen Supply Chain Family V7.3 installation DVD into your DVD
drive. The AspenTech Installer automatically detects any AspenTech
software that is installed on your computer.
Note: If your company has set up Aspen Supply Chain Family software for
installation from a network-accessible drive, you can perform this task
over the network without a DVD. Locate the directory that contains the
Aspen Supply Chain Family installation kit and double-click setup.exe.
For additional details, see the aspenONE Deployment Guide.
Aspen Supply Chain Family includes the following products: Aspen
Collaborative Forecasting (CF), Aspen CAPs, Aspen SCM, Aspen Supply
Chain Connect, and Aspen Supply Chain Analytics.
The AspenTech Installation Browser dialog box appears, and a popup
window informs you that you need to configure license information.
If this dialog box does not appear a few seconds after inserting a DVD,
browse to the DVD drive and launch setup.exe in the DVD folder.

26

3 Uninstalling Aspen CAPs

Click OK. The AspenTech Installation Browser Welcome dialog box


appears.

Click Next. The AspenTech Installation Browser License


Configuration Type dialog box appears.

Select the desired method of product licensing:


o

License Server Select this option if you want to use only license
files located on a network license server.

Standalone License File Select this option if you want to use only
license files that are located on your local machine.

3 Uninstalling Aspen CAPs

27

Both Select this option if you want to use license files that are
located on a network license server and license files that are located
on your local machine.

Important: Do not select the None option when installing Aspen Supply
Chain Family products.
5

Click Next.

If you selected Standalone License File or Both on the AspenTech


Installation Browser License Configuration Type dialog box, the
AspenTech Installation Browser License Files dialog box appears.

The License Filename field displays a list of license files. If the desired
license file name does not appear in the list, click Add License File and
navigate to the location of the license file.
Click Next.

28

3 Uninstalling Aspen CAPs

If you selected License Server or Both on the AspenTech Installation


Browser License Configuration Types dialog box, the AspenTech
Installation Browser License Servers dialog box appears.

This dialog box displays a list of license servers. If the desired license
server name does not appear in the list, click Add Server and navigate to
the location of the license server.
Click Next. The AspenTech Installation Browser Determining
Licensed Products dialog box appears.

3 Uninstalling Aspen CAPs

29

10 Wait while the installation program reads your license files and determines
the products for which you have valid licenses. When this process is
complete, the installation program displays a Completed message and
indicates the number of licenses found.
The Licenses field displays a list of products for which you have valid
licenses.
11 Click Next. The AspenTech Installation Browser dialog box appears
again.

12 Select the Products tab.


13 Expand DVD 2 Manufacturing & Supply Chain, and then select
Aspen Chemical Supply Chain.
14 Click Install to begin the installation process. The Welcome dialog box
appears after a few seconds.
15 Click Next. The Program Maintenance dialog box appears.
16 To remove the indicated Aspen Supply Chain Suite products, select the
Remove option and click Next. The Remove the Program dialog box
appears and prompts for confirmation before starting the removal of
Aspen Supply Chain Suite features.
17 Click Remove to begin the removal of all features in the Aspen Supply
Chain Suite.
Caution: After confirming removal on the Remove the Program dialog
box, it is not possible to reverse the removal. Ensure you want to uninstall
all features in the Aspen Supply Chain Suite before proceeding.
To reinstall Aspen Supply Chain Suite features after removal, see the
Installing Aspen CAPs chapter.

30

3 Uninstalling Aspen CAPs

Index

A
about this guide 5
Add/Remove Utility 25
Aspen CAPs, installing 12
Aspen SCM 8
aspenONE overview 6
AspenTech support 9
AspenTech Support Center 9
audience for this guide 5
B
background colors
editors 9
C
CAPs
required software 8
upgrading 18
CAPs, installing 12
Computer Configuration Type dialog box 17
customer support 9
D
documentation 7
E
e-bulletins 9
editors
background color 9
font 9
F
fonts 9

31

Index

H
help desk 9
I
installation summary 18
installing CAPs 12
L
label fonts 9
libraries, shared 8
M
Microsoft Add/Remove Utility 25
N
new Aspen CAPs installation 12
R
Ready to Install dialog box 18
S
SCM 8
server install 17
shared libraries 8
software requirements 8
standard install 17
support, technical 9
T
technical support 9
U
uninstalling CAPs 25
upgrading CAPs 18
W
web site, technical support 9

32

Index