Advanced Process Control

Validated Process for APC Online

Installation and Configuration

V10
Version Number: 10
June 2017
Copyright (c) 2017 by Aspen Technology, Inc. All rights reserved.

Aspen APC Manager, Aspen Apollo, Aspen Cim-IO, Aspen DMC3, Aspen DMCplus (with SmartStep technology),
Aspen DMCplus Builder, Aspen DMCplus Composite, Aspen Inferential Qualities, Aspen Inferential Quality Builder,
Aspen InfoPlus.21, Aspen IQ, Aspen IQmodel Powertools, Aspen Nonlinear Controller, Aspen Online Deployment,
Aspen PID Watch, Aspen PID Watch Performance Monitor, Aspen Process Controller, Aspen Process Recipe, Aspen
Process Recipe Manager, Aspen Process Sequencer, Aspen Process Statistical Analyzer, Aspen Production Control
Web Server, Aspen Recipe Explorer, Aspen RTO Watch, Aspen RTO Watch Performance Monitor, Aspen SmartAudit,
Aspen State-Space Controller, Aspen Transition Manager, Aspen Watch, Aspen Watch Performance Monitor, Aspen
Manufacturing Suite Advanced Process Control, AspenTech, aspenONE, and the aspen leaf logo are trademarks or
registered trademarks of Aspen Technology, Inc., Bedford, 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.

20 Crosby Drive
Bedford, MA 01730
USA
Phone: (1) (781) 221-6400
Toll Free: (888) 996-7100
URL: https://www.aspentech.com
Contents
1 Introduction .........................................................................................................1
About this Document ........................................................................................ 1
Related Documents .......................................................................................... 1
Reference Architecture Diagram ......................................................................... 1
Servers Configuration ....................................................................................... 2
Basic Deployment Recommendations .................................................................. 4
Minimum server configurations for example applications ............................. 5

2 Installation Workflow...........................................................................................7
Install Workflow ............................................................................................... 7
Determine servers and class of software ................................................... 8
Software requirements and Install Media ................................................... 9
Additional Relevant Information ............................................................... 9
Third-party Software ............................................................................ 10

3 APC Software Install ..........................................................................................12

Installing Third Party Software ......................................................................... 12
Install Java™ (JRE) prerequisite for Web Server installation ....................... 12
Install Internet Information Services (IIS) ............................................... 12
New Advanced Process Control Installation ........................................................ 20

4 APC Software Post-install...................................................................................28

APC Desktop.................................................................................................. 28
APC Performance Monitor ................................................................................ 29
Starting IP.21 Manager ......................................................................... 29
Running Install DB Config...................................................................... 30
Configure CIM-IO Logical Devices ........................................................... 32
Logical Device Example ......................................................................... 34
APC Online .................................................................................................... 35
Network Time Protocol (NTP) ................................................................. 35
CIM-IO for OPC .................................................................................... 35
Configure APC Online server .................................................................. 40
Configure Cim-IO interface for APC Online server ..................................... 44
APC Web Server ............................................................................................. 45
Verify APC Web Data Provider ................................................................ 45
ADSA Configuration .............................................................................. 46

iii
iv Contents
1 Introduction

About this Document

This document is intended to describe the contents of the Aspen Advanced
Process Control configuration. It is intended for APC Engineers or IT personnel
to reference when installing APC software for the first time.
The following sections describe the implementation process, beginning with
the staging of the configuration through the final deployment.
This document does not describe how to install Aspen Software License
Manager and it is focused on APC software installation assuming a license
serer is available. This document does not cover the migration of existing
controllers and files.

Related Documents
Installation and Configuration guide (describes how to install, and configure
software on the reference architecture)
Validated Process Test document.
Advanced Process Control V10 Installation Guide:
https://esupport.aspentech.com/S_Article?id=000044966
APC Configuration guide: available after install APC Online software.
C:\Program Files (x86)\Common Files\AspenTech
Shared\APCConfigurationGuide\default.htm

Reference Architecture
Diagram
Advanced Process Control (APC) V10 is implemented using the reference
architecture and specific versions of AspenTech software. The reference
architecture is made up of hardware and third-party software that are typical
in providing a secure IT infrastructure.
The diagram below shows the reference architecture that was configured and
used to execute the accompanying APC V10 Validated Processes. Detailed
system-level information is provided in the chart and tables that follow.

1 Introduction 1
 Note: APC Online, APC Performance Monitor, and APC Web Server
communicate over Local Area Networks (LANs), with remote client
connections via the WAN.
Later sections of this document present additional details regarding the order
of the installation and APC V10-specific instructions.
The hardware specifications listed in the next section are the AspenTech
reference architecture specifications used to qualify APC V10. Customers may
use this information as a reference guide and can make adjustments
according to their particular IT policies and requirements. The configuration
documented in this guide reflects the actual configuration used in the APC
qualification and is intended for reference purposes only.

Servers Configuration
Below is the list of machines used during this validated process workflow. The
software and hardware used in this configuration can be considered best
practice. However, the section Basic Deployment Recommendations provides
good insights about minimum hardware specs for APC servers. The software
requirements are presented in Chapter 2.

2 1 Introduction
Comp. 3rd Party/ Release Hardware & OS Client/
Solution Comment
# AspenTech Version Specification Server

MS Hyper-V Aspen APC Desktop in

2 vCPU, 8 GB RAM, above diagram, used for
50GB disk offline modeling and
Aspen APC application configuration.
1 AspenTech V10 Client
Builder V10
Windows 8.1 (x64)
<or> Windows 10
(x64) Professional

MS Hyper-V Aspen APC Online Server

Aspen APC 4 vCPU, 12 GB in above diagram, used for
Builder V10 RAM, 100GB disk online application
2 AspenTech V10 Server deployment.
Aspen APC Windows Server
Online V10 2012 R2 (x64)
Datacenter

3 AspenTech Aspen APC V10 MS Hyper-V Server Aspen APC Performance

Builder V10 4 vCPU, 12 GB Monitor Server in above
RAM, 100GB disk diagram, used for collection
of online application
Aspen APC
Windows Server (history) data and adaptive
Online V10
2012 R2 (x64) modeling.
Datacenter

4 AspenTech Aspen APC V10 MS Hyper-V Server Aspen Production

Builder V10 4 vCPU, 12 GB Control Web Server in
RAM, 100GB disk above diagram, used for
web display of online
Aspen APC
Windows Server applications.
Online V10
2012 R2 (x64)
Datacenter

5 AspenTech Aspen Plus V9 V9 MS Hyper-V Server [Optional] Virtual Process

4 vCPU, 16 GB Plant in above diagram,
RAM, 100GB disk used for online process
Aspen HYSYS
simulation and regulatory
V9
Windows Server DCS control.
2012 R2 (x64)
Standard

6 Third Party Internet IE11 Windows 7, Client Desktop on WAN

Explorer Windows 8.1 <or>
Windows 10, 8 GB
RAM

In the section below we provide additional information to help setting the

server structure.
The AMS Advanced Process Control products installations have been
consolidated into four software classes:
1. APC Desktop
2. APC Online

1 Introduction 3
 3. APC Web Server
4. APC Performance Monitor
The products in each class are listed below.
APC Desktop
 Aspen DMC3 Builder for building Aspen DMC3 or APC applications
 Aspen Nonlinear Controller Builder
 Aspen DMCplus Desktop for building Aspen DMCplus or Aspen DMC3
applications
 Aspen Inferential Quality Builder
 Aspen PID Watch Performance Monitor
 Aspen SmartAudit
APC Online
 Aspen DMC3 (when running as an online server product)
 Aspen DMCplus Controller (with Aspen SmartStep technology)
 Aspen DMCplus Composite
 Aspen Inferential Qualities
APC Web Server
 Aspen Production Control Web Server
APC Performance Monitor
 Aspen Real Time Optimizer (RTO) Watch Performance Monitor Server
 Aspen Watch Performance Monitor Server

Basic Deployment
Recommendations
Due to performance considerations, APC Performance Monitor (Aspen
Watch) should always be installed on a dedicated server machine.
For APC Web Server and APC Online classes of software, if the machine
has sufficient memory and number of cores (6 to 16 GB of memory and 6 to 8
cores or more) allocated to run the APC Software, then it may be viable to
install APC Online and APC Web Server on the same computer. Obviously,
several criteria—such as the number and size of the applications, and the
number of web users—dictate how many processing cores and memory are
required.
Running all classes of Aspen Process Control software on virtual machines is
acceptable. However, a virtual machine must be given sufficient processing
cores (2 to 4, minimum) and memory allocation (4GB, minimum) in order to
perform well in a production environment.
Installing APC Desktop products on an APC Online server is perfectly
acceptable for uses such as modifying controller configurations. However,
extensive use of the desktop tools on an online server may interfere with the
performance of the online controller applications.

4 1 Introduction
 Minimum server configurations for example
applications
The following notes exemplify server configurations that are minimal, but
acceptable, in installations where recommended hardware recommendations
cannot be met.

APC Online
 All APC Online server products require a minimum of two virtual
processors (four is recommended), and a minimum of 4 GB of RAM to
function.
 The DMCplus / DMC3 control engine is not computationally intensive, and
four virtual processors and 4 GB of RAM are sufficient if the following
conditions exist:
o A hosted Composite application is of moderate size (<200 variables).
o Number of future MV moves is limited to 14, and the controller is of
moderate size (<50 MVs).
o Move Plan Option (DYNOPT) is set to zero (0). Setting the DYNOPT=3
increases the computational requirements.
o Maximum controller size is moderate (i.e., <50 MVs per controller),
and the total number of controllers is less than ten.

APC Web Server

 It is recommended that you install Aspen Production Control Web Server
on a dedicated Windows server. However, it may be viable to install APC
Online and APC Web Server on the same computer if the machine has
sufficient memory and number of cores (more than 16 GB of memory and
6 to 8 cores or more). Several criteria—such as the number and size of
the applications, and the number of web users—dictate how many
processing cores and memory are required.
 APC Web Server requires a minimum of four virtual processors and 4 GB
of RAM to function.
 As noted above, it may be viable to install both APC Online and APC Web
Server on the same computer. However, when both are installed on the
same computer, the server should have proportionally more memory and
virtual processors.
 APC Web Server needs progressively more memory if more than 10 users
are concurrently connected to the machine, or if more than 200 variables
(MVs and CVs) exist in online applications, or if more than 10 Aspen IQ
applications are being displayed.

APC Performance Monitor

 APC Performance Monitor (Aspen Watch) requires a minimum of four
virtual processors and 4 GB of RAM to function.
 As noted above, APC Performance Monitor should always be installed on a
dedicated server machine.

1 Introduction 5
  For calculating actual hard disk space required, see the
WatchDiskSizeCalcs.xls file, available from AspenTech Support1 or,
after installation, from the Tools folder.
APC Performance Monitor requires a high performance processor (as
recommended in "Error! Reference source not found.") if the sum of MVs and C
Vs for all controllers it monitors exceeds 200 in total.

The following chapters outline the installation and configuration steps taken to
implement APC V10. Each chapter outlines the steps involves for one of the
machines used in the APC implementation.

Note: The components were installed in the order listed in these chapters.
Any exceptions to the rule are explicitly noted.
 Chapter 2: Installation Workflow
 Chapter 3: APC Software Installation
 Chapter 4: Post-Install

1
Aspen Watch Disc Size Calculation Spreadsheet:
http://support.aspentech.com/webteamasp/KB.asp?ID=135042

6 1 Introduction
2 Installation Workflow

Install Workflow
In order to ensure a complete and smooth installation, a basic workflow with
the main important steps is proposed.

2 Installation Workflow 7
 In this workflow user would start the software installation by defining the
number of servers and their requirements. After that, the class of software for
each server is defined. The install media could be available in a shared drive
in the network. Before proceeding with the installation in each server, make
sure that the pre-requisites (windows features and roles) for each server are
installed. For each class of software, confirm if any third-party software is
needed. Once that step is completed, proceed with the software installation
and then check the post install configuration.
The sections below provide more details on the steps in the flowchart above.

Determine servers and class of software

The workflow starts by defining the number of servers and the structure to be
deployed. As a possible configuration you could have one server with APC
Online, Desktop and APC Web server and another server with APC
Performance Monitor.
The second step is to determine the class of software to be installed in each
machine. As described in the previous chapter, these are the class of software
for Advanced Process Control:

 APC Desktop

 APC Online

 APC Web Server

 APC Performance Monitor

This would be a simple configuration:

Note: firewall configuration is not displayed here.

8 2 Installation Workflow
 Software requirements and Install Media
Determine whether software and hardware requirements have been met.
Determine the licensing method that is in use at your site, and select the
appropriate installation DVD.

 Software requirements (see section below).

 Hardware requirements (use the reference architecture and the basic

deployment recommendations).

 Prior to installation, ensure the Windows Firewall Service is

STARTED.
If the Windows Firewall Service is NOT started, the installation
completes. However, the installer does not configure needed port
exceptions in the Windows Firewall.

Important: Effective as of version V8.4, the installation and operation of APC

(desktop or server) products on Windows Server 2003, Windows XP, or
Windows Vista are not supported.
Virtualization is supported. Refer to Knowledge Base Solution ID: 137801 for
additional information.
Supported Platforms for APC Software
See the V10 Platform Specifications for Advanced Process Control (APC)
Products at the following website:
https://www.aspentech.com/platform-support/

Important: Effective as of version V8.4, installation and operation of APC

(desktop or server) products on Windows Server 2003, Windows XP, or
Windows Vista are not supported.

Additional Relevant Information

Notes:
 Aspen Production Control Web Server does not run on a Windows Terminal
Server.
 You must be logged into an account with Administrator privilege when first
downloading AspenTech plotting components on the Web client.

Note: All installation procedures in this guide assume you are using an
account with FULL administrator privileges, including privileges to write to the
Windows Registry. If installation fails, consult your Information Services (IS)
personnel to determine if there are group policies or some other restrictions
in force that limit the capability of local administrators.

2 Installation Workflow 9
 Third-party Software
In this section, the list of third-party software used in APC Software is
presented.
Java™ 8 or later – 32-bit (i.e., Windows x86 or i586)

Required for APC Web Server.

JRE is available as a download from here:
http://www.oracle.com/technetwork/java/javase/downloads/i
ndex.html.
Click on Java SE then JRE (Download):

You should see the list of jre files to download:

Accept the license and then download the Window x86 Offline, copy the
downloaded file to the APC Web Server and install using Admin rights.

10 2 Installation Workflow
 Microsoft IE 9 or later. (IE10 and IE11 are recommended.)
Internet Explorer (IE) is required for computers accessing the APC Web
Interface. Besides, APC Web Server and Performance Monitor also
require IE 9 or later.

Note: Google Chrome Evergreen 49 or later is also supported for client

computers that access APC Web Server, in all views except the Aspen
Process Sequencer interface.

Microsoft Internet Information Server (IIS) 7.5 or 8.5

IIS is required for the APC Web Server. The next chapter will show how
to install this feature in Windows Server. IIS is available with Windows
Server 2008 R2 SP1 Standard Edition; Windows Server 2012 R2 and
Windows Server 2016.

 On Windows Server 2008 R2 SP1, IIS is enabled by configuring a Web Server

(IIS) Role through the Server Manager Add Roles option.
 On Windows Server 2012 R2, IIS is enabled by configuring a Web Server (IIS)
Role using the Server Manager Add roles and features Dashboard.

Microsoft .NET Framework 4.5.2 and 4.6

Required for Aspen APC Desktop, APC Web Server, Aspen
Performance Monitor and Aspen InfoPlus.21 software components.

2 Installation Workflow 11
3 APC Software Install

This chapter is divided in three parts: 1) Installing Third Party Software, 2)

Installing Windows Features and 3) Installing APC Software.

Installing Third Party Software

Install Java™ (JRE) prerequisite for Web
Server installation
>>> APC Web Server product
Installation of Aspen Production Control Web Server requires that the
following third-party software be installed as a prerequisite:
 32-bit (i.e., Windows x86 or i586) Java version 8 (JRE 8) or later version.
Se chapter 2, page 11 on how to install the Java Runtime Environment.

Notes:
 During installation, always clear check boxes that include "Optional 3rd
Party Installations."
 To complete the JRE installation in an environment where there is no
Internet connection, you can obtain the "Windows Offline (32-bit)"
installation file for Java on a separate computer that has an Internet-
connection. Look for the offline installation file.
 When the JRE installation is complete, verify that it is installed by
inspecting the Windows Control Panel. The Windows Control Panel should
include a Java (32-bit) applet.

Install Internet Information Services (IIS)

>>> APC Web Server and APC Performance Monitor products
Microsoft IIS must be installed prior to installing APC Web Server and APC
Performance Monitor products. Use the following steps to install IIS, as
appropriate for the Windows Server version you are using.
You will need your Windows installation media to complete this task.

12 3 APC Software Install

 Important: Microsoft does not support moving IIS 7.0 and later from its
default location. For details, see the following Microsoft Knowledge Base (KB)
article: http://support.microsoft.com/kb/2752331.

To install IIS on Windows Server 2016:

1 Click the Find taskbar icon, and enter “Server Manager” as the search
term.
2 Click to open the Server Manager desktop app.
3 In the Server Manager app, select Dashboard.
4 In the Server Manager Dashboard page, select Add roles and
features.
The Add Roles and Features Wizard dialog is displayed.
5 If the Before you Begin page is displayed, click Next.
6 In the Installation Type page, select the Role-based or feature-based
installation option. Then click Next.
7 In the Server Selection page, confirm that the appropriate server is
selected in the Server Pool frame, and then click Next.
8 In the Server Roles page, select the Web Server (IIS) row from the
Roles list. The Add Roles and Features Wizard dialog box is displayed.
9 In the Add Roles and Features Wizard dialog box:
o Select the Include management tools (if applicable) check box.
o Then click the Add Features button to add web server and
management tools features.
As a result, the Add Roles and Features Wizard dialog box closes.
Focus returns to the Server Roles page, where the Web Server (IIS)
check box is now enabled and selected.
10 In the Server Roles page, now that the Web Server (IIS) role check
box is enabled and selected, click Next.
11 In the Features page, select the following items from the Features list.
Note: As you select items, allow the wizard to add required dependent
features and services.
.NET Framework 3.5 Features .NET Framework 4.6 Features
 .NET Framework 3.5  .NET Framework 4.6
 ASP.NET 4.6
 WCF Services | HTTP Activation
 WCF Services | TCP Port Sharing
12 Return to the Server Roles page.
From the Roles list, expand the Web Server (IIS) node and, under it,
expand the Web Server node. This enables you to select the following
items.
Note: As you select items, allow the wizard to add required dependent
features and services.

3 APC Software Install 13

 Common HTTP Features Application Development
 Default Document  .NET Extensibility 3.5
 Directory Browsing  .NET Extensibility 4.6
 HTTP Errors  ASP
 Static Content  CGI
 HTTP Redirection  ASP.NET 3.5
 ASP.NET 4.6
Health and Diagnostics
 ISAPI Extensions
 HTTP Logging
 ISAPI Filters
 Request Monitor
 Server Side Includes
Performance
Management Tools
 Static Content Compression
 IIS Management Console
Security  IIS 6 Management Compatibility
 Request Filtering (NOTE: Enable ALL sub-items for
 Basic Authentication this service.)
 Digest Authentication  IIS Management Scripts and Tools
 Windows Authentication

Note: FTP Server and SMTP Service are not required and can be omitted
from the IIS install.
13 In the Confirmation page, click Install.
14 After the features are installed, the Results page is displayed. Click
Close.
15 Close the Server Manager Dashboard when all tasks are completed.

To install IIS on Windows Server 2012 R2:

1 From Control Panel, in the Programs section, click the Turn Windows
features on or off link.

The Server Manager Dashboard is displayed.

14 3 APC Software Install

 Afterwards, the Add Roles and Features Wizard is displayed.

2 If the Before you Begin page is displayed, click Next.

3 In the Installation Type page, select the Role-based or feature-based
installation option. Then click Next.

3 APC Software Install 15

 4 In the Server Selection page, confirm that the appropriate server is
selected in the Server Pool frame, and then click Next.

5 In the Server Roles page, select the Web Server (IIS) row from the
Roles list. The Add Roles and Features Wizard dialog box is displayed.

16 3 APC Software Install

 6 In the Add Roles and Features Wizard dialog box:
o Select the Include management tools (if applicable) check box.
o Then click the Add Features button to add web server and
management tools features.
As a result, the Add Roles and Features Wizard dialog box closes.
Focus returns to the Server Roles page, where the Web Server (IIS)
check box is now enabled and selected.

3 APC Software Install 17

 7 In the Server Roles page, now that the Web Server (IIS) role check
box is enabled and selected, click Next.
8 In the Features page, select the following items from the Features list.
Note: As you select items, allow the wizard to add required dependent
features and services.
.NET Framework 3.5 Features .NET Framework 4.5 Features
 .NET Framework 3.5  .NET Framework 4.5
 ASP.NET 4.5
 WCF Services | HTTP Activation
 WCF Services | TCP Port Sharing

18 3 APC Software Install

 9 Return to the Server Roles page.
From the Roles list, expand the Web Server (IIS) node and, under it,
expand the Web Server node. This enables you to select the following
items.
Note: As you select items, allow the wizard to add required dependent
features and services.
Common HTTP Features Application Development
 Default Document  .NET Extensibility 3.5
 Directory Browsing  .NET Extensibility 4.5
 HTTP Errors  ASP
 Static Content  ASP.NET 3.5
 HTTP Redirection  ASP.NET 4.5
 CGI
Health and Diagnostics
 ISAPI Extensions
 HTTP Logging
 ISAPI Filters
 Request Monitor
 Server Side Includes
Performance
Management Tools
 Static Content Compression
 IIS Management Console
Security  IIS 6 Management Compatibility
 Request Filtering (NOTE: Enable ALL sub-items for
 Basic Authentication this service.)
 Digest Authentication  IIS Management Scripts and Tools
 Windows Authentication

Note: FTP Server and SMTP Service are not required and can be omitted
from the IIS install.
10 In the Confirmation page, click Install.

3 APC Software Install 19

 11 After the features are installed, the Results page is displayed. Click
Close.
12 Close the Server Manager Dashboard when all tasks are completed.

To install IIS on Windows Server 2008 R2 SP1:

1 From Control Panel, below the Programs tasks list, click the Turn
Windows features on or off link.
The Server Manager dialog box is displayed.
2 Expand the Roles node, and select Web Server (IIS).
If Web Server (IIS) is not one of the enabled roles, then click Add
Roles, and add it.
After the role is added, then add Role Services, as described next.
3 In the right pane of the Server Manager dialog box, find the Web
Server (IIS) section, and click Add Role Services.
Add the following Role Services. (NOTE: When you are selecting them,
allow Windows to add the required dependent role services, if prompted.):
Common HTTP Features Security
 Static Content  Basic Authentication
 Default Document  Windows Authentication
 Directory Browsing  Digest Authentication
 HTTP Errors  Request Filtering
 HTTP Redirection
Performance
Application Development  Static Content Compression
 ASP.NET
Management Tools
 .NET Extensibility
 IIS Management Console
 ASP
 IIS Management Scripts and Tools
 CGI
 IIS 6 Management Compatibility
 ISAPI Extensions
(NOTE: Enable ALL sub-items for
 ISAPI Filters
this service.)
 Server Side Includes
Health and Diagnostics
 HTTP Logging
 Request Monitor

Note: FTP Server and SMTP Service are not required and can be omitted
from the IIS install.
4 Close the Server Manager dialog box and Programs and Features
window when complete.

New Advanced Process Control

Installation
There are a few steps involved in installing APC software in a new system.
Before start, make sure you have installed the required third-party software
as described in the previous chapter. Follow the steps below for each server
where APC software is installed.

20 3 APC Software Install

 1 Log on to the network using the account name and password of an
account in the Administrators group of the target computer.
2 Do one of the following:
o If you are installing from a network drive, map to the drive that
contains the aspenONE software installation for Aspen Manufacturing
and Supply Chain, and double-click setup.exe.
o If you are installing from a local drive, locate the aspenONE USB drive
letter and folder for Aspen Manufacturing and Supply Chain, and
double-click setup.exe.
The "Welcome..." screen of the AspenTech Installation Browser is
displayed.
If your computer is 64-bit capable, this is indicated as illustrated below.
Afterwards, 32-bit / 64-bit programs are automatically selected and
installed depending on the products you choose.

3 APC Software Install 21

 3 Click Install aspenONE products.
The Software License Terms screen is displayed.

4 Accept the terms of the software agreement (select the check box) and
click Next. The software prerequisites are verified.

In this example, prerequisite component Microsoft .NET 4.5.2 is

preventing the installation from proceeding. If you see a similar error,
please go back to step 8 of page 18 and follow the procedure to install
the appropriate Microsoft software components.

22 3 APC Software Install

 5 Click Next. The screen for product selection is displayed.

6 Expand the aspenONE Aspen Advanced Process Control Family

selection, and select the products to install.

For example: a possible server configuration would be:

Server 1: Install Aspen APC Desktop, APC Online and Aspen APC Web
Server.
Server 2: Install Aspen APC Performance Monitor.

3 APC Software Install 23

 7 After selecting products to install, click the File Location tab. Accept the
default root folder path for installation, or modify, if desired.

Important:
 After any AspenTech software product has been installed in the root
folder, the root folder destination cannot be changed, and the File
Location tab will be disabled. All further AspenTech product installations
on this computer will be made to that root folder by default.
 Common components are always installed under Program Files
(x86)\Common Files\AspenTech Shared, regardless of the root folder
destination (File Location) specified.
 There are environment variables that point to the Program Files and
Program File (x86) directories on the system drive and the installation
program is using. These type of environment variables do not exist for
other drives.
ProgramFiles=C:\Program Files
ProgramFiles(x86)=C:\Program Files (x86)
ProgramW6432=C:\Program Files
 If your computer is 64-bit capable, and you choose to install to an
alternate drive or folder location, for example: E:\, the 32-bit software
application files are installed to an "E:\AspenTech (x86)" folder, and 64-
bit software application files are installed to an "E:\AspenTech" folder.

24 3 APC Software Install

 8 After you select products and specify a file location, click Next. The screen
for specifying licensing and security is displayed.

9 Specify the SLM License Server and, if applicable, the Aspen Framework
Security Server or Aspen Local Security Server. Then click Next.
Note: Aspen Framework Server is a security server for large-group,
enterprise installations. If applicable, verify that your system
administrator has installed the Aspen Framework Server.
The screen for identifying the Windows services account is displayed.

3 APC Software Install 25

 10 Enter the logon criteria for the Windows services account and click Next.
The summary screen to verify your installation is displayed.

11 Click Install Now. An installation progress screen is displayed.

26 3 APC Software Install

 12 After installation is complete, you may see the following message,
instructing you to reboot your system.

o Click Reboot Now to restart your computer.

13 After the system restart is complete, log onto Windows using the same
username and password you used to install the software.
14 Follow all instructions in the "After You Install" sections of the online help,
APC Configuration Guide, which is displayed in your computer's web
browser immediately after you reboot the computer.
15 If you close the APC Configuration Guide, you can always access it again
from this location: C:\Program Files (x86)\Common Files\AspenTech
Shared\APCConfigurationGuide\default.htm.

The next chapter provides some additional configuration needed for each
class of software: APC Builder Products, APC Online Products, APC Web
Server and APC Performance Monitor.

3 APC Software Install 27

4 APC Software Post-install

In this chapter we provide the main configuration tasks needed after installing
Aspen APC software.
In this chapter we review the post-configuration install needed for each class
of software:

 APC Desktop

 APC Online

 APC Web Server

 APC Performance Monitor

APC Desktop
>>> APC Online, Web Server and Performance Monitor
If the Windows Firewall feature in the Windows operating system is enabled,
you will need to click Unblock in the Windows Security Alert dialog box the
first time you run certain desktop products and attempt to connect to an
online server. If you see the follow screen, just click the “Allow access”
button.

28 4 APC Software Post-install

 APC Performance Monitor
For an Aspen Watch Server, the main configuration item is the database and
also make sure that IP.21 Manager runs properly.

Starting IP.21 Manager

After install APC Performance Monitor, make sure IP.21 Manager is started.
1. Click Start | Programs | AspenTech | Aspen Manufacturing Suite
| Aspen InfoPlus.21 | InfoPlus.21 Manager.
Tip: For Windows Server 2012, press the Windows key  + Q, and
search for "InfoPlus.21 Manager".

2. In the InfoPlus.21 Manager window, click Start InfoPlus.21.

Note: After completing the installation, always leave Aspen

InfoPlus.21 running. Stop Aspen InfoPlus.21 only when you need to
shut down your computer.

3. Watch the status bar at the bottom of the window for a message
stating that InfoPlus.21 has been started successfully:

4 APC Software Post-install 29

 Running Install DB Config
4. Use Aspen Watch Maker to start the Install Database Configuration
utility by following these steps:
o From the Windows Start menu, click Programs | AspenTech
| Aspen Manufacturing Suite | APC Performance Monitor |
Watch Maker (APC).
-or-
o From the Windows Start screen, search ( + Q) for "Watch
Maker", and then select the Watch Maker (APC) shortcut.
o From the main menu of Aspen Watch Maker, click File | Install
Database Configuration.

o Click Yes in the User Account Control dialog to run the

Install Database Configuration utility as Administrator, in
order to give the script sufficient privilege to run successfully.

30 4 APC Software Post-install

 5. After the Install Database Configuration utility starts, press ENTER
to accept the Yes [Y] default and start the database configuration.
There is very little interaction required, other than deciding whether to
continue with the procedure. You may see a significant amount of
informational text scroll by if this is an upgrade.
Watch the window for the message "Aspen Watch database configuration
successfully completed."
6. After the database restarts at the end of the procedure, press any key
to exit the Install Database Configuration window.
Also exit the Aspen Watch Maker program.

Note: If you receive an error, look in one of the following files for
more information:
o PROGRAMDATA\etc\cfg\awlog.txt
o PROGRAMDATA\etc\cfg\upgrade.out
...where PROGRAMDATA, for typical installations, is...
C:\ProgramData\AspenTech\APC\Performance Monitor.

7. Exit InfoPlus.21 Manager, and then reopen it to update the list of

Defined Tasks.
8. Confirm that the following Aspen Watch Performance Monitor tasks are
listed under Running Tasks:

TSK_ADM1 TSK_ADM2 TSK_AW01

TSK_AW02 TSK_AW03 TSK_AW04

TSK_AW05 TSK_M_IODEV1 TSK_M_IODEV2

TSK_M_IODEV3 TSK_M_IODEV4 TSK_MSC1

TSK_MSC2 TSK_MSC3 TSK_PID1

4 APC Software Post-install 31

 TSK_PID2 TSK_PID3 TSK_IQ1

TSK_IQ2 TSK_IQ3 TSK_IQ4

TSK_IQ5 TSK_ACP1 TSK_ADAP

TSK_RTO1 TSK_RTO2 TSK_RTO3

TSK_RTO4

9. From the Defined Tasks list in the InfoPlus.21 Manager window,

double-click TSK_HLTH, and then clear the Skip during startup
check box.
Then click the RUN TASK button to start the external task, TSK_HLTH.

Configure CIM-IO Logical Devices

In order for the online control software to communicate with the device-
specific Cim-IO server, a TCP/IP service must be defined for the server. A
TCP/IP service has both a name and a port number. The port number can be
any unique number higher than 5000. Lower numbers are reserved for
standard services and system use.
The port number assigned to the Cim-IO TCP/IP service on the Aspen Watch
Performance Monitor server must match the port number used by the
appropriate online applications host server.
After completing these instructions, the edited Services file for the Aspen
Watch Performance Monitor server should contain lines that appear similar to
the example screenshot below:

The CIMIODMCP line specifies the default configuration for the Aspen DMCplus
Context Cim-IO server. The cimiosetcim_200 line specifies an optional
configuration for another Cim-IO device from which you might want to read or
write Aspen InfoPlus.21 data.

32 4 APC Software Post-install

 The Program Files (x86)\AspenTech\CIM-IO\cimio_logical_devices.def file
must be configured to include a cimiosetcim_200 DLGP Service for
communication with the APC Online server, as shown below:

If you want Aspen Watch to communicate with the OPC server you could add
an extra line in the cimio_logical_devices.def file. For example:
IODEV5 OPC_Server_Name CIOASPENTECH_01
will establish communication between the Aspen Watch server and the OPC
server. In this case the CIOASPENTECH_01 must be a tcp service as in the
example below.
Additionally, the cimiosetcim_200 TCP port configuration specified in the
Windows\System32\drivers\etc\services file must be configured consistently
in the APC Online server and APC Performance Monitor server:

A Defined Task can be created in the Aspen InfoPlus.21 Manager to facilitate

the Cim-IO Setcim DLGP communications between the APC Online server and
APC Performance Monitor server. For example, you could use the
CIMIOSETCIM to read/write tags from/to Aspen Watch database for an APC
controller.

4 APC Software Post-install 33

 Logical Device Example
Below is an example of a configured CIM-IO logical device:
LogicalDeviceName NodeName DLGPServiceName
(a unique device (host node name) (the Cim-IO service
name) name)
OCPSRV01 OPCServerName CIMIOOPC
IODMCP DMCplusOnlineServerName CIMIODMCP
IOIP21 AspenWatchServerName CIMIOSETCIM_200
IODEV1 DcsServerName1 CIMIODCS1
IODEV2 OPCServerName CIMIOOPC
 Line 1 in this example file is the CIM-IO used to access the OPC server
and establish communication with the process.
 Line 2 is the logical device used to access the DMCplus Context
Service. Aspen Watch uses this device to read data from the
controllers.
 Line 3 specifies an optional Cim-IO device from which you might want
to read / write Aspen InfoPlus.21 data, usually the Aspen Watch
server.
 Lines 4 and 5 specify additional Aspen Watch Performance Monitor
Cim-IO devices.

34 4 APC Software Post-install

 APC Online
This section describes the main configuration items for the APC Online server.
The CIM-IO for OPC is the main configuration task and can also be repeated
for the Aspen Watch Server in case the Aspen Watch server needs to connect
to the OPC server.

Network Time Protocol (NTP)

Data with time stamps is transmitted to and from AspenTech products on
multiple servers for storage, processing, and analysis. Unless the clock
times on those various computers are exactly the same, it is difficult to
compare and analyze time-stamped events. For this reason, it is important to
implement an NTP scheme to synchronize the clocks on all of your network
computer systems.
Consult your site's network policies and Microsoft Server documentation for
instructions on how to establish NTP on your network and / or connect APC
Online and APC Web servers as clients to Windows Time service.

CIM-IO for OPC

For systems that require Aspen Cim-IO for OPC as an interface to one or
more OPC (Open Platform Communications) servers, you should perform the
following configuration steps, which enable automatic server connections
during Aspen Cim-IO Server startup.
Tip: If you install Aspen Cim-IO components (Cim-IO Server and Cim-IO for
OPC) on the same machine that is hosting OPC servers, it eliminates the need
to configure DCOM permissions.
Below is the list of some important knowledge base articles related to DCOM
and OPC communication in case of issues connection the APC Online with
OPC:

DCOM considerations when OPC Server is remote to Aspen Cim-IO for OPC interface.
Solution ID: 108885
Product(s): Aspen Cim-IO for OPC

CIMIO_T_API synchronous works with a remote CIM-IO/OPC connection, but why doesn’t
asynchronous?
Solution ID: 133142
Product(s): Aspen Cim-IO for OPC, Aspen Inferential Qualities

Aspen Cim-IO for OPC gets "Access denied" when connecting to a remote Fisher Delta V
OPC server.
Solution ID: 115547

4 APC Software Post-install 35

 Product(s): Aspen Cim-IO for OPC

Configuring CIM-IO for OPC

Start in V10 the OPCProperties.exe is no longer available and the CIM-IO
Interface Manager is the preferred way to configure CIM-IO connections. For
example, the CIM-IO for OPC configuration can be done by opening the CIM-
IO Interface Manager program:

Then click the Add CIM-IO Interface… link under Actions on the top right
corner. This will open the following dialog:

36 4 APC Software Post-install

 Here you can select the CIM-IO interface to be configured, in this case, the
CIM-IO for OPC. Click next:

In this dialog you can set the interface name and description and also
configure a specific user account to connect. Click next:

4 APC Software Post-install 37

 In the Interface step of the wizard you can point to a server and retrieve the
OPC information. In this example, the APCOTS machine has an OPC DA server
for OTS (Operator Training Simulator) – AspenTech.OTS_OPServer. The CIM-
IO for OPC will point to this server to retrieve data from OPC. Click next and
the finish:

Return to the CIM-IO Interface Manager and you should see this:

38 4 APC Software Post-install

 The interface is started.
Open the cimio_logical_devices.def file in Notepad and add a new line as
shown below:

Open the test-api utility and confirm tags can be read from the OPC server:

4 APC Software Post-install 39

 Configure APC Online server
Click the Online navigation button in DMC3 Builder. The Online view includes
object nodes for selection of Servers and Applications.

40 4 APC Software Post-install

 Click the Online Servers node, and then click the Configure Server ribbon
element.
The Configure Online Server dialog box enables you to:
 Set up the current machine as an Aspen DMC3 online server, running
deployed Aspen DMC3 applications.
 Configure the quantity and intervals at which application snapshots
and history data are stored on the server.
 Configure the security roles and permissions for the users who access
the server or the online applications and data that are hosted on the
server.
 Identify one or more input / output (IO) sources that can interface
between the online applications, which are residing on the current
server, and the plant distributed control systems (DCS).

Check the Enable Server checkbox to enable the APC Online server, which
will start the AspenTech Production Control RTE Server after the configuration
changes are saved.

4 APC Software Post-install 41

 The IO tab allows you to configure the IO Sources that will be used to
communicate with the controller.

Click the Add Source button, then configure an IOIP21 Cim-IO Data Source
as shown below, then click Add Source to save the configuration. Note that
the Hostname for the DLGP Service is the APC Performance Monitor server.

42 4 APC Software Post-install

 Click the Permissions tab, and enable Execute permissions for Start/Stop
Application, Deploy Application, Delete Application, Get Snapshot History, and
Configure Auto-Start operations.

Click the Users and Roles tab, and configure an appropriate user account for
the online application permissions.

4 APC Software Post-install 43

 Click OK to apply changes and close the Configure Online Server dialog.
When the configuration is saved and dialog is dismissed, click the Server
Configuration Add ribbon element.
Specify a name for the APC Online server and (APC Online server) Host, as
shown below, then click OK.

Configure Cim-IO interface for APC Online

server
The Program Files (x86)\AspenTech\CIM-IO\cimio_logical_devices.def file
must be configured to include a cimiosetcim_200 DLGP Service for
communication with the APC Performance Monitor server, as shown below:

44 4 APC Software Post-install

 Additionally, the cimiosetcim_200 TCP port configuration specified in the
Windows\System32\drivers\etc\services file must be configured consistently
in the APC Online server and APC Performance Monitor server:

APC Web Server

Verify APC Web Data Provider
Before you can access the Aspen Production Control Web site, you must verify
that the Aspen APC Web Provider Data Service starts and runs correctly.
Access the windows services and make sure the service is started as in the
example below:

4 APC Software Post-install 45

 ADSA Configuration
The History and Optimizer areas of Aspen Production Control Web Server
contain an ADSA Information page. In this page, you can view the list of
ADSA data sources that Aspen Production Control Web Server is accessing.
To open the APC Web Interface press the Windows key  + Q and search for
APC Production Control web while logged in the server. When operating from
the client machine, open Internet Explorer and enter the
http://servername/atcontrol, where server name is the name (or IP
address) of the machine where the web server was installed.

1. On the server where Aspen Production Control Web Server is installed,

click Start | Programs | AspenTech | Common Utilities | ADSA
Client Config Tool.

Tip: From the Start screen of Windows Server 2012, press the
Windows key + Q, and search for "ADSA Client".

2. The ADSA Properties dialog box is displayed.

46 4 APC Software Post-install

 2. If you do not wish to use the ADSA Server installed on the Aspen
Production Control Web Server computer, select or enter the machine
name that has your InfoPlus.21 connections defined in the Directory
Server box.
-or-
If you do wish to use the ADSA Server installed on the Aspen Production
Control Web Server computer, and you wish to define your own Public Data
Sources, click the Public Data Sources button, and add the Data Sources.

4 APC Software Post-install 47