Aspen Configured Applications (CAPs)

8/10/2019 Aspen Configured Applications (CAPs)

1/32

Installation Guide

Aspen Configured Applications (CAPs)


2/32

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 IntegrationInfrastructure, Aspen Information Management, Aspen Batch, Aspen Production Management, Aspen AdvancedProcess Control, Aspen Supply Chain Analytics, Aspen Collaborative Forecasting (CF), aspenONE, the aspen leaflogo 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 AspenTechproprietary and confidential information and may not be disclosed, used, or copied without the prior consent ofAspenTech or as set forth in the applicable license agreement. Users are solely responsible for the proper use ofthe software and the application of the results obtained.

Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the softwaremay be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES 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 RoadBurlington, MA 01803-5501USAPhone: (781) 221-6400Website: http://www.aspentech.com


3/32

Contents iii

Contents1 Introduction.........................................................................................................5

About this Installation Guide..............................................................................5

Related Documentation .....................................................................................5aspenONE Overview .........................................................................................6

System Requirements.......................................................................................7

Technical Support ............................................................................................9

2 Installing Aspen CAPs ........................................................................................11

Before You Install........................................................................................... 11

Installing Aspen CAPs ..................................................................................... 12Upgrading 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 .......................................... 26Uninstalling Aspen CAPs Using the aspenONE Method ......................................... 26

Index ....................................................................................................................31


4/32

iv Contents


5/32

1 Introduction 5

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 GuideThis document describes how to install Configured Applications (CAPs) on

Windows.

Note:This document does not include the installation of AspenTech industryfeatures.

AudienceThis installation guide is intended for anyone who needs to install CAPs,

including system administrators, application developers, and end users.

Related DocumentationIn addition to this document, AspenTech provides the following

documentation for Aspen CAPs:

Aspen CAPs Release Notes

Help for each CAP

Implementation Guide for each CAP


6/32

6 1 Introduction

aspenONE OverviewAll 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.

PackagingIncluded in your package from AspenTech, you will find the following itemsthat 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 DVDsThe 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 usedseparately to browse the documentation and install PDF documentation.

aspenONE Product DVDs includes a number of DVDs that contain theinstallations for Aspen products. For a complete description of the

contents of those DVDs, refer to the aspenONE Deployment Guide.

Start InstallationTo begin an installation, insert the appropriate DVD into your DVD drive. Youwill 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 beforeyou 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, DVDcontent can be shared from a network server.

AspenTech Installation BrowserThe AspenTech Installation Browser provides a mechanism for users to

validate their product licenses and browse through the products that they arelicensed for prior to installation. The AspenTech Installation Browser containstwo tabs, Administration and Products.


7/32

1 Introduction 7

From the Administration tab, you can install the Aspen Administrationproducts 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 Technologysupport centers and web sites for contact information, product updates and

other resources. A link is also provided to easily access the licenseconfiguration wizard to determine which products you are licensed for

installation.

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

For more information, see the aspenONE Deployment Guide.

Aspen Documentation DVDBefore installing any AspenTech product, be sure to print and read theinstallation guide and release notes documentation for each product youintend to install. All AspenTech installation and reference documents (in PDF

format) and standalone versions of Help files are included on the aspenONEDocumentation DVD.

Each product-specific installation guide contains critical information about

system requirements, product dependencies, and post-installationconfiguration procedures. The release notes for each product containinformation 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 eachCAP:

Help

Implementation Guide

System RequirementsThis section describes the system requirements for the Aspen CAPs.


8/32

8 1 Introduction

Required HardwareThe hardware requirements for installing CAPs are the same as the

requirements for Aspen SCM. For details, see the Aspen SCM Installation

Guide.

Required SoftwareThe 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 defaultfolder, 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 SCMmodules. For details, see the Implementation Guide for each CAP.

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

Required Software SettingsIn order to display Aspen SCMs user interface elements correctly, you mustspecify 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 asscreen resolution, are not in effect.

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

Required Windows Settings

Screen resolution The CAPs support the following screen resolutions:

o 1024 x 768

o 1280 x 1024

o 1400 x 1050

o 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 ofmultiple rows (Note - this is the Windows default setting), or the AutoHide 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.


9/32

1 Introduction 9

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, clickOptions | System | Window Attributes.2 Click theLabel Fonts button for Graph Windows, Planning Board

Windows, Presentation Graphics (Chart) Windows, and Dialog Windows

3 Set the font to MS Sans Serif, 8 pt.

To change the Editor Window fonts:

1 In SCM, clickOptions | System | Editors | Font.

2 Set Header font to MS Sans Serif, 8 pt.

3 Set Cell font to Lucida Console, 8 pt.

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

To change the Editor Window background color:

1 In SCM, clickOptions | System | Editors | Color.

2 Set the Background color to Microsoft Gray.

Technical SupportAspenTech customers with a valid license and software maintenanceagreement 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 supportinformation such as:

Technical advisories

Product updates and releases

Customer support is also available by phone, fax, and email. The most up-to-

date contact information is available at the AspenTech Support Center athttp://support.aspentech.com.
http://support.aspentech.com/http://support.aspentech.com/http://support.aspentech.com/http://support.aspentech.com/


10/32

10 1 Introduction


11/32

2 Installing Aspen CAPs 11

2 Installing Aspen CAPs

This chapter explains how to install the current versions of the Aspen CAPs. Itincludes 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 AspenTechInstaller 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 CAPswithin the AspenTech Supply Chain family of products.

Before You InstallBefore installing Aspen CAPs, you must perform the following pre-installationtasks:

Install Aspen SCM. For details, see theAspen 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\

o Windows XP and Windows 2003 Server C:\Documents andSettings\All Users\Documents\AspenTech\Aspen CAPS


12/32

12 2 Installing Aspen CAPs

During the installation process, you can select a different location ifdesired.

Select a directory to contain the CAPs shared libraries. The default locationfor Aspen CAPs shared libraries is:

C:\Program Files\AspenTech\Aspen CAPs\Shared Libraries

During the installation process, you can select a different location ifdesired.

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 forinstallation from a network-accessible drive, you can install CAPs over the

network without a DVD. Locate the directory that contains the AspenSupply Chain Family installation kit and double-click setup.exe. Foradditional details, see the aspenONE Deployment Guide.

Aspen Supply Chain Family includes the following products: Aspen

Collaborative Forecasting (CF), Aspen CAPs, Aspen SCM, Aspen SupplyChain 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.


13/32


2 Click OK. The AspenTech Installation Browser Welcome dialog boxappears.

3 Click Next. The AspenTech Installation Browser LicenseConfiguration Type dialog box appears.

4 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.

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

o Both Select this option if you want to use license files that are

located on a network license server and license files that are locatedon your local machine.

Important:Do not select the None option when installing Aspen SupplyChain Family products.

5 Click Next.


14/32


6 If you selectedStandalone License File or Both on the AspenTech

Installation Browser License Configuration Type dialog box, the

AspenTech Installation Browser License Files dialog box appears.

7 The License Filename field displays a list of license files. If the desiredlicense file name does not appear in the list, click Add License File andnavigate to the location of the license file.

ClickNext.

8 If you selectedLicense Server or Both on the AspenTech Installation

Browser License Configuration Types dialog box, the AspenTech

Installation Browser License Servers dialog box appears.


15/32


9 This dialog box displays a list of license servers. If the desired licenseserver name does not appear in the list, click Add Server and navigate to

the location of the license server.

ClickNext. The AspenTech Installation Browser Determining

Licensed Products dialog box appears.

10 Wait while the installation program reads your license files and determinesthe products for which you have valid licenses. When this process iscomplete, 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 validlicenses.

11 Click Next. The AspenTech Installation Browser dialog box appearsagain.


16/32


12 Select the Products tab.

13 Expand DVD 2 Manufacturing & Supply Chain, and then selectAspen 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.


17/32


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 Installand Server Install options are identical.

21 The Feature Selection dialog box appears, displaying all products withinthe Aspen Supply Chain family of products for which you are licensed.

22 Select the CAPs you want to install.

o The icon indicates that a feature is not currently installed.

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

o Click the down arrow to display a menu that allows you to choose the

method of installation:

Click to install the feature.

Click to install the feature and all its subfeatures.

The Feature Selection dialog box displays the location where thesoftware will be installed. The default destination is:

C:\Program Files\AspenTech\Aspen CAPS\

Note: The folder for Demand Manager, Distribution Scheduler, InventoryPlanner, 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\


18/32


o 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 AspenCAPs 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 isaccurate. If so, click Install to start the Aspen CAPs installation.

To make changes, click the Backbutton 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 dialogbox prompts you to close running applications before proceeding with theinstallation.

24 When the Wizard Completed dialog box appears, click Finish.

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

To upgrade Aspen CAPs:


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 thenetwork without a DVD. Locate the directory that contains the AspenSupply 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: AspenCollaborative Forecasting (CF), Aspen CAPs, Aspen SCM, Aspen SupplyChain Connect, and Aspen Supply Chain Analytics.

The AspenTech Installation Browser dialog box appears, and a popupwindow 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.
http://support.aspentech.com/http://support.aspentech.com/


19/32


20/32


o Both Select this option if you want to use license files that arelocated on a network license server and license files that are located

on your local machine.


5 Click Next.6 If you selectedStandalone License File or Both on the AspenTech



7 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 andnavigate to the location of the license file.

ClickNext.


21/32










22/32


10 Wait while the installation program reads your license files and determinesthe products for which you have valid licenses. When this process is

complete, the installation program displays a Completed message and




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 boxappears after a few seconds.



23/32


24/32



25/32

3 Uninstalling Aspen CAPs 25

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

2 Microsoft Taskbar3 aspenONE Removal

Uninstalling Aspen CAPs Usingthe Microsoft Add/Remove

Utility

To uninstall features and subfeatures using the MicrosoftAdd/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.

2 Select the desired CAPs and clickRemove.

3 Click Yesto confirm removal of the feature. The Windows Installer begins

the removal.

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

Programsdialog box.


26/32

26 3 Uninstalling Aspen CAPs

Uninstalling Aspen CAPs Usingthe Microsoft Taskbar

To uninstall features and subfeatures using the Microsofttaskbar:

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

Uninstall AspenTech Software. The AspenTech Uninstaller SelectProductsdialog box appears.

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

3 Click Uninstall. Removal of the selected features begins.

4 When the uninstallation is complete, clickClose on the AspenTechUninstaller Uninstall Progress dialog box.

Uninstalling Aspen CAPs Usingthe aspenONE Method

To uninstall features and subfeatures using the aspenONE

removal method:


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 forinstallation from a network-accessible drive, you can perform this task

over the network without a DVD. Locate the directory that contains theAspen 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 SupplyChain 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.


27/32


2 Click OK. The AspenTech Installation Browser Welcome dialog box

appears.

3 Click Next. The AspenTech Installation Browser License

Configuration Type dialog box appears.

4 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.

o Standalone License File Select this option if you want to use only

license files that are located on your local machine.


28/32


o Both Select this option if you want to use license files that arelocated on a network license server and license files that are located

on your local machine.


5 Click Next.6 If you selectedStandalone License File or Both on the AspenTech



7 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 andnavigate to the location of the license file.

ClickNext.


29/32










30/32


10 Wait while the installation program reads your license files and determinesthe products for which you have valid licenses. When this process is

complete, the installation program displays a Completed message and




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.


16 To remove the indicated Aspen Supply Chain Suite products, select the

Removeoption 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 SupplyChain Suite.

Caution:After confirming removal on the Remove the Program dialogbox, 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 theInstalling Aspen CAPs chapter.


31/32

31 Index

Index

A

about this guide 5

Add/Remove Utility 25Aspen CAPs, installing 12

Aspen SCM 8aspenONE overview 6

AspenTech support 9AspenTech Support Center 9

audience for this guide 5

B

background colors

editors 9

C

CAPs

required software 8upgrading 18

CAPs, installing 12Computer Configuration Type dialog box 17

customer support 9

D

documentation 7

E

e-bulletins 9

editorsbackground color 9font 9

F

fonts 9


32/32

H

help desk 9

I

installation summary 18

installing CAPs 12

L

label fonts 9libraries, shared 8

M

Microsoft Add/Remove Utility 25

N

new Aspen CAPs installation 12

R

Ready to Install dialog box 18

S

SCM 8server install 17

shared libraries 8software 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