Commissioning Aspentech® Infoplus.21™ Historian
Commissioning Aspentech® Infoplus.21™ Historian
Commissioning Aspentech® Infoplus.21™ Historian
0
Commissioning Section
Issue Date 0101
TECHNICAL BULLETIN
Introduction........................................................................................................*3
Key Concepts.....................................................................................................*4
AspenTech InfoPlus.21 Historian................................................................................... *4
InfoPlus.21 Tools ........................................................................................................... *4
File Sets ........................................................................................................................ *5
Database Word Size ...................................................................................................... *7
Back Up and Restore..................................................................................................... *8
* Indicates those sections where changes have occurred since the last printing.
Commissioning AspenTech
InfoPlus.21 Historian
Introduction
This document describes how to configure the AspenTech
InfoPlus.21 Historian database. This document describes how to:
• start and stop InfoPlus.21
• back up the InfoPlus.21 Historian database
• restore an InfoPlus.21 Historian database
• view file set information
• modify database configuration parameters
• modify file set subdirectories
• configure database word size
• archive a database file set
• restore a database file set
4 Commissioning
Key Concepts
AspenTech InfoPlus.21 Historian
The InfoPlus.21 Historian provides long-term storage of historical data
in an efficient and economical system of repositories that contain disk
archive files. The InfoPlus.21 Historian is composed of one or more
repositories each containing:
• a Queue and possible Queue files
• a Cache and Cache file
• two or more archive file sets
• the h21 archive process
Each repository is a complete, self-contained, history system.
Historical data is placed into a memory-resident Queue. The h21
archive process transfers the entries from the Queue into a
memory-resident Cache where they are indexed by record ID and by
timestamp. The archiving process removes the indexed entries from
the Cache and stores them in disk archive files called file sets.
The InfoPlus.21 Historian quickly and efficiently retrieves stored data
from the file sets for use in the system whenever it is required.
InfoPlus.21 Tools
Several tools are included with AspenTech InfoPlus.21. The
three tools typically used include: InfoPlus.21 Administrator,
InfoPlus.21 Manager, and History/21 Monitor.
InfoPlus.21 Administrator
Allows users to explore and interact with local and remote InfoPlus.21
systems. Use the Administrator to search databases for specific
records, retrieve database properties, create new folders, create and
modify records, add history repositories, set history parameters, and
add file sets.
Commissioning AspenTech InfoPlus.21 Historian 5
History/21 Monitor
Backs up, restores, and repairs InfoPlus.21 history repository file sets.
The History/21 Monitor is a DOS based program that must run on the
Windows NT computer that contains the InfoPlus.21 Historian
database. The History/21 Monitor consists of a set of screens and
command-line text entries that can be used to look at the current trend
and message log (GWS only) database configuration and modify the
configuration parameters.
InfoPlus.21 does not create a menu for History/21 Monitor. Launch the
program from the following directory:
C:\AspenTech\InfoPlus21\c21\h21\bin\h21mon.exe.
InfoPlus.21 Manager
Manages groups and tasks in the database and includes instructions for
the History/21 utility programs provided with InfoPlus.21. Creates and
manages InfoPlus.21 groups and the tasks associated with the
database.
File Sets
All long-term historical tag data collected in a plant is stored within
archive files, which form part of a self-contained group of related files
called a file set. Each repository should have a minimum of three file
sets: one to use, another to shift to, and a third file set for restoring
archival backups. There is a maximum limit of 100 file sets per
repository. The number of file sets needed depends on the amount of
data you want to keep available for immediate access by users and the
way you want to archive older data. For example, you might set up
13 file sets, specifying that 12 should be used to store data for a month
at a time and the 13th should not be used for storage of new data. This
would allow users access to the most recent 12 months of data and
provide you with a place to restore an older file set if, at any time,
someone needs to see archived data that goes back further than the last
12-month period.
Each file set holds all the data for a continuous period of time for all
included tags, for example, from 10 December 98 11:27:45 to
15 Jan 99 05:34:32.
6 Commissioning
Each file set has a data file, a long-record data file, and a companion
key file that reside under the same directory. The files in a set always
have the names: arc.dat, arc.byte, and arc.key. Since all archive file
sets contain the same file names, the file sets must be maintained in
separate directories.
The data file (arc.dat) contains variable length data records up to
256 bytes. Each record contains multiple history samples saved for the
same tag. Each history sample contains a timestamp having
microsecond resolution, a key level, and the other fields defined for
the historical occurrence.
The records for a specific tag are linked together by pointers creating a
continuous time history. The size of the records is determined by the
activity of the tag. Active tags with many events are given larger, more
efficient records, while quiet tags have small records to minimize
wasted space when the file set shifts.
If it takes more than 256 bytes to store any data sample, the data file
contains a pointer to the long-record data file and the data sample itself
is stored in that file (arc.byte).
The key file (arc.key) is an index that has one entry for each data
record in the data file. The keys are the Tag ID, starting time, and
ending time of the corresponding records. The key file allows the
system to go directly to the correct starting record when the tag and
time are given. After that, data retrieval is a simple matter of reading
linked records for the tag and jumping across file set boundaries where
necessary. To the client programs, such as Aspen Process Explorer, it
appears as one continuous, time-based record.
By definition, the file set in use for storing data is called the active file
set. It receives all the current data samples (although other file sets can
also be updated by edits or backdated events, such as delayed lab
samples). As data samples are stored, the active file set grows until it
reaches its size limit, threshold, or preset time limit. The system then
shifts into the next available file set. The previously active file set
becomes permanently bounded by the start and end times of its active
period. Normally there are no time gaps between file sets except where
old sets have been restored from an archive tape.
File sets can be set up based either on size or time. So you can have a
file set collect data until it reaches a certain preset size or you can
specify that it will collect data from 10 December 98 11:27:45 to
15 Jan 99 05:34:32 and then shift to a different file set.
Commissioning AspenTech InfoPlus.21 Historian 7
If the database word size is set up much larger than the actual size of
your database, excess computer memory is allocated for the database
but not used. This lowers the performance of the system. The proper
word sizes are set up during installation.
Only modify this value to correct an error from the installation.
Database word size is setup from the data user entered in configuration
dialog during installation. If a lower value is entered during
installation and trend collector fails with this error, change the
maximum word size parameter to increase it. You do not have to
reinstall the software.
Procedure Overview
Table 1: Commissioning AspenTech InfoPlus.21 Historian
To Do This Follow These Steps:
Start and Stop InfoPlus.21 Select Windows Start menu > Programs > AspenTech >
InfoPlus.21 Manager. Click either Start InfoPlus.21 or Stop InfoPlus.21.
Back Up the InfoPlus.21 Stop InfoPlus.21. Shut down all the clients connected to the
Historian Database InfoPlus.21 Historian. Back up the following:
• all file sets
• InfoPlus21.snp file. The default location is
C:\AspenTech\InfoPlus21\db21\group200.
• All files in the data configuration subdirectory. The default location is
C:\AspenTech\InfoPlus21\c21\H21\dat.
Start InfoPlus.21.
Restore an InfoPlus.21 Stop InfoPlus.21. Shut down all the clients connected to the
Historian Database InfoPlus.21 Historian. Copy and paste the following files from the backed
up database:
• all file sets
• InfoPlus21.snp file. The default location is
C:\AspenTech\InfoPlus21\db21\group200.
• All files in the data configuration subdirectory. The default location is
C:\AspenTech\InfoPlus21\c21\H21\dat.
Start InfoPlus.21.
View File Set Information Select Windows Start menu > Programs > AspenTech > InfoPlus.21
Administrator. Select Group 200 > Historian > TSK_DHIS > File Sets.
Modify Database Configuration Select Windows Start menu > Programs > AspenTech > InfoPlus.21
Parameters Administrator. Right click on the database, TSK_DHIS, and select
Properties. Calculate proper database configuration parameters using
Table 6. Edit the fields in the Properties dialog box and click OK. Enter
the new parameters in the Pending edit boxes.
Modify File Set Subdirectories Select Windows Start menu > Programs > AspenTech > InfoPlus.21
Administrator. Select Group 200 > Historian > TSK_DHIS > File Sets.
Right-click on a file set and select Properties.
Configure Database Word Size Select Windows Start menu > Programs > AspenTech >
InfoPlus.21 Manager. Click on TSK_DBCLOCK task in the defined tasks
section. Calculate the total number of words (space) required:
(x * 146) + (y*627) + 39731w here x is the number of trend tags and
y is the number of message log tags. Change the value following the
DOUBLE in the Command line parameters field to the value calculated
with the formula above. Click the Update button.
Archive a Database File Set In Windows NT Explorer, double-click on the History/21 application:
C:\AspenTech|InfoPlus21\c21\h21\bin\h21mon.exe. At the H/21mon>
prompt, type DATES. Enter the command SETREP TSK_DHIS so the
trend database is the database being backed up. At the H/21mon>
prompt, type PAUSE. Back up the desired file set. At the H/21mon>
prompt, type PROCESS.
Restore a Database File Set In Windows NT Explorer, double-click on the History/21 application:
C:\AspenTech|InfoPlus21\c21\h21\bin\h21mon.exe. At the H/21mon>
prompt, type DATES. At the H/21mon> prompt, type PAUSE. Select one
of the old file sets not needed. Dismount the selected file set. Restore the
old file set into the file set number just dismounted. Type: MOUNT –a.
Then type: PROCESS.
10 Commissioning
Detailed Procedures
Starting and Stopping InfoPlus.21
To start and stop InfoPlus.21:
1. Select Windows Start menu > Programs > AspenTech >
InfoPlus.21 Manager. The InfoPlus.21 Manager dialog box
appears (Figure 1).
Notes
24 Commissioning
Notes
www.johnsoncontrols.com
Controls Group FAN 646.0
507 E. Michigan Street M-Historian Technical Manual
P.O. Box 423 Release 2.0
Milwaukee, WI 53201 Printed in U.S.A.