Platform Manager
Platform Manager
Platform Manager
User’s Guide
11/26/14
All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or
transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the
prior written permission of Invensys Systems, Inc. No copyright or patent liability is assumed with respect
to the use of the information contained herein. Although every precaution has been taken in the
preparation of this documentation, the publisher and the author assume no responsibility for errors or
omissions. Neither is any liability assumed for damages resulting from the use of the information
contained herein.
The information in this documentation is subject to change without notice and does not represent a
commitment on the part of Invensys Systems, Inc. The software described in this documentation is
furnished under a license or nondisclosure agreement. This software may be used or copied only in
accordance with the terms of these agreements.
All terms mentioned in this documentation that are known to be trademarks or service marks have been
appropriately capitalized. Invensys Systems, Inc. cannot attest to the accuracy of this information. Use of
a term in this documentation should not be regarded as affecting the validity of any trademark or service
mark.
Alarm Logger, ActiveFactory, ArchestrA, Avantis, DBDump, DBLoad, DT Analyst, Factelligence,
FactoryFocus, FactoryOffice, FactorySuite, FactorySuite A2, InBatch, InControl, IndustrialRAD,
IndustrialSQL Server, InTouch, MaintenanceSuite, MuniSuite, QI Analyst, SCADAlarm, SCADASuite,
SuiteLink, SuiteVoyager, WindowMaker, WindowViewer, Wonderware, Wonderware Factelligence, and
Wonderware Logger are trademarks of Invensys plc, its subsidiaries and affiliates. All other brands may
be trademarks of their respective owners.
3
Contents
Welcome .................................................... 5
Document Conventions .................................................................... 5
Where to Find Additional Information ........................................... 6
Technical Support ............................................................................ 6
Index....................................................... 27
Welcome
Document Conventions
This documentation uses the following conventions:
Technical Support
Wonderware Technical Support offers a variety of support options to
answer any questions on Wonderware products and their
implementation.
Before you contact Technical Support, refer to the relevant section(s)
in this documentation for a possible solution to the problem. If you
need to contact technical support for help, have the following
information ready:
• The type and version of the operating system you are using.
• Details of how to recreate the problem.
• The exact wording of the error messages you saw.
• Any relevant output listing from the Log Viewer or any other
diagnostic applications.
• Details of what you did to try to solve the problem(s) and your
results.
• If known, the Wonderware Technical Support case number
assigned to your problem, if this is an ongoing problem.
Chapter 1
Getting Started
Security
For all ArchestrA administrative utilities, including Platform
Manager, security is configured through the IDE. By default, there is
no security enabled for Platform Manager or any of the other utilities.
There are four authentication modes for security that can be enabled
for Platform Manager:
• No authentication
• Galaxy authentication mode
• OS User Based authentication mode
• OS Group authentication mode
Galaxy Authentication
Galaxy authentication requires the user to log on to Platform Manager
every time the utility is started.
OS Group Authentication
In OS Group authentication, the user defines roles that match OS
Groups. At log on, the OS Groups are matched with the roles.
For more information about security and authentication, see the
Application Server User’s Guide.
Changing Users
If security is enabled from the IDE, the user is logged in (either
manually or automatically) when you open the Platform Manager.
If security is disabled in the IDE, clicking Change User results in no
action. The command is ignored.
Chapter 2
Using Platform Manager, you can monitor and change the state of any
platform or engine in your Galaxy application.
Note: The Platform Manager and Object Viewer utilities use different
time-out functions for determining the status of an AppEngine on a
remote node when a network connection is broken. This problem
results in a Not Available status for the object. When viewing this
changing status in the Platform Manager, the response time may be
different from the Object Viewer. This is normal functionality.
Checkpointed State
When managing platforms and engines, the platform saves the last
scanned state of an object to a local hard drive. This act is called
checkpointing and the last scanned state is known as the checkpointed
state. Checkpointing allows for the quick recovery of an object’s state
in the event of a failure without the dependence on the application’s
database or GalaxyRepository.
Platforms and engines that are started by Platform Manager are
started in their checkpointed scan state. When stopping platforms and
engines, their last scan state is checkpointed.
3 To set the order in which the platforms are displayed, click on the
Platform Name or Node Name column header.
Column Description
Column Description
3 In the details pane, locate the engine and view its status in the
Engine Status column.
Each column is described in the following table. You can change the
order in which the columns are displayed, and you can add or delete
columns.
To change the columns, click on the platform name in the console tree,
select the View menu, and then click on Add/Remove Columns... You
can also bring up this option by right-clicking on the platform name.
Column Description
Exporting Lists
It may be helpful for you to export the resulting object status to a list.
You can do this by using the MMC export function located from the
console menu bar or on the console toolbar.
To export a list
On the Action menu bar, select Export List. A dialog box appears,
allowing you to save the items in the resulting pane as either plain
text or Unicode text.
Managing Platforms
After commanding a platform to a new state, you can view the
transition status in the Operation Status column in the details pane.
In the console tree, the name of the platform will be preceded by an
asterisk (*) if the status of the platform is anything other than
Running On Scan. For example, if a platform is running off scan or if it
is shut down, its name will be preceded by an asterisk.
The action of placing a platform on scan occurs when you place a
platform in a run-time state in which it is performing its normal
processing as part of its execute method. However, you can place a
platform off scan, which is the state that indicates that it is idle and
not ready for execution. You can also control the startup and shutdown
of platforms.
Sorting Platforms
You can change the order in which the platforms are listed in the
detail pane. To sort the platforms, either click on the column that you
want to use for sorting, or right click on the galaxy name in the console
tree to bring up a context menu. Then, select the column name you
want to use for sorting the platforms from the menu. Platforms can be
sorted by:
• Platform Name
• Node Name
• Platform ID
See "Viewing Platform Status" on page 15 for additional information
about these columns.
The status for the platform changes from Running Off Scan to
Running On Scan, which indicates the platform is performing
normally. The asterisk will no longer appear next to the platform
name in the console tree.
3 Click No to cancel the operation or click Yes to put the engines off
scan before setting the platform off scan.
4 The status for the platform changes from Running On Scan to
Running Off Scan and the platform becomes idle. The platform
name is now preceded by an asterisk.
Starting a Platform
After a platform is stopped, it can be restarted by Platform Manager in
either the on scan or off scan state if its Start Up mode is configured to
Manual Start. You can verify the platform’s configuration from the
IDE.
If a platform’s Start Up mode is configured to Auto Start, then it starts
automatically in its last checkpointed scan state when the power is
reapplied to the computer.
To start a platform
1 From the details pane, right-click the platform, and then click
Start Platform. The Startup Platform dialog box appears.
2 Select Off Scan or On Scan, and then click OK to set the platform’s
startup scan state.
The platform begins to start and its status changes from
Shutdown to Starting Off Scan or Starting On Scan. After the
platform starts successfully, its status changes from Starting Off
Scan or Starting On Scan to Running Off Scan or Running On
Scan. If the platform is running off scan, an asterisk will precede
the platform name in the console tree. No asterisk will be
displayed if the platform is running on scan.
The status of all hosted engines changes from Shutdown to
Running Off Scan.
Note: You cannot undo this operation, and you cannot add a platform
through the Platform Manager. You must use the IDE to add a platform.
Managing Engines
You can view the transition status of an engine from the Operation
Status column in the details pane after changing an engine to a new
state.
The action of placing an engine on scan occurs when you place an
engine in a run-time state in which it is performing its normal
processing as part of its execute method. However, you can place an
engine off scan, which is the state that indicates that it is idle and not
ready for execution. You can also control the startup and shutdown of
engines.
If you are using redundancy, you can control the run-time state of the
redundant pairs the same way you would for a standalone engine. You
can also initiate a forced failover, where the active engine is placed in
standby status and the standby engine becomes active.
Icon Description
Engine on standby
Engine is shutdown
Engine Redundancy
Status Status Description
Engine Redundancy
Status Status Description
The status for the engine changes from Running Off Scan to
Running On Scan, which indicates the engine is performing
normally. Any hosted ApplicationObject is also set on scan, you can
verify this using Object Viewer.
Starting an Engine
To start an engine, the status of the platform that hosts the engine
must be Running On Scan and the engine’s Start Up mode must also
be configured to Manual Start. You can verify the engine’s
configuration from the IDE.
If the engine’s Start Up mode is configured to Auto Start, then the
platform starts the engine in the last checkpointed scan state. Engines
configured in the Semi Auto Start mode start in the Off Scan state.
To start an engine
1 From the details pane, right-click the engine, and then click Start
Engine.
The Startup Engine dialog box appears.
Index
A document conventions 5
Action menu 11, 17 domain 8
administrative utility
DAServer Manager 7, 9 E
Galaxy Database Manager 7, 9 engine
Log Viewer 7, 9 category 17
Object Viewer 5, 11 failure 16
application database 14 ID 17
ApplicationObject 25 identity 17
ArchestrA System Management Console 7, 9 managing 22
authentication modes 9 name 17
Auto Start mode 19, 25 off scan 25
on scan 24
C shutting down 21, 26
checkpointing 14, 19 starting 25
column description 15 status 13, 16, 17
configure security 9 tag name 17
console menu bar 17 type 17
console toolbar 17 Engine Status column 17
console tree 9 exporting object status 17
D F
DAServer Manager 9 failure
default user 10 engine 16
deployed platform 8 network 15
platform 15 ID 15
managing 18
G name 15
Galaxy application 8 node name 15
Galaxy authentication 10 off scan 18, 19
Galaxy Database Manager 9 on scan 18
GalaxyRepository 8, 14 shutting down 20
sorting 18
H starting 19
hosted engine 20 start-up configuration 19
status 13, 15, 16
I Platform Manager Logon 8
IDE 9, 10, 11, 19 Platform Status column 15
idle 14
install 8 R
Integrated Development Environment (IDE) redundancy 23
User’s Guide 6 root node 9
L S
Log Viewer 9 security 9
authentication modes 9
M disabled 10
Manual Start mode 19 password 8
Microsoft Management Console 5, 7 user name 8
MMC 7, 17 Semi Auto Start mode 25
MMC toolbar 5 shutting down
engine 21, 26
N platform 20
network failure 15 SMC 7, 9
node 8 snap-ins
normal processing 14 DAServer Manager 7, 9
Not Deployed state 13 Galaxy Database Manager 7, 9
Log Viewer 7, 9
O starting
Object Viewer 5, 6, 11 engine 25
Off Scan status 14 platform 19
On Scan status 14 Platform Manager 8
Operation Status column 16, 17, 18, 22 start-up mode 19, 25
OS Group authentication 10 Auto Start 19, 25
OS User authentication 10 Manual Start 19, 25
Semi Auto Start 25
P state
partner checkpointed 14
platform 17 description 13
status 17 off scan 14
password 8 on scan 14
platform status
failure 15 engine 16
platform 15 Unicode 17
System Management Console 7, 9 transition 13, 15, 16, 17, 22
T U
text user name 8
plain 17