Professional Documents
Culture Documents
Panel
Administration and Configuration Guide
Version 2013
October 2012
DSCP-100004A
Copyright
Copyright © 2012 Intergraph Corporation. All Rights Reserved.
Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement;
contains confidential and proprietary information of Intergraph and/or third parties which is protected by copyright law, trade
secret law, and international treaty, and may not be provided or otherwise made available without proper authorization from
Intergraph Corporation.
U.S. Government Restricted Rights Legend
Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies: This was
developed at private expense and is "restricted computer software" submitted with restricted rights in accordance with
subparagraphs (a) through (d) of the Commercial Computer Software - Restricted Rights clause at 52.227-19 of the Federal
Acquisition Regulations ("FAR") and its successors, and is unpublished and all rights are reserved under the copyright laws of
the United States. For units of the Department of Defense ("DoD"): This is "commercial computer software" as defined at DFARS
252.227-7014 and the rights of the Government are as specified at DFARS 227.7202-3.
Unpublished - rights reserved under the copyright laws of the United States.
Intergraph Corporation
P.O. Box 240000
Huntsville, AL 35813
Terms of Use
Use of this software product is subject to the End User License Agreement ("EULA") delivered with this software product unless
the licensee has a valid signed license for this software product with Intergraph Corporation. If the licensee has a valid signed
license for this software product with Intergraph Corporation, the valid signed license shall take precedence and govern the use
of this software product. Subject to the terms contained within the applicable license agreement, Intergraph Corporation gives
licensee permission to print a reasonable number of copies of the documentation as defined in the applicable license agreement
and delivered with the software product for licensee's internal, non-commercial use. The documentation may not be printed for
resale or redistribution.
Warranties and Liabilities
All warranties given by Intergraph Corporation about equipment or software are set forth in the EULA provided with the software
or applicable license for the software product signed by Intergraph Corporation, and nothing stated in, or implied by, this
document or its contents shall be considered or deemed a modification or amendment of such warranties. Intergraph believes
the information in this publication is accurate as of its publication date.
The information and the software discussed in this document are subject to change without notice and are subject to applicable
technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in this document.
The software discussed in this document is furnished under a license and may be used or copied only in accordance with the
terms of this license. No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not
supplied by Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL
EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.
Intergraph is not responsible for the accuracy of delivered data including, but not limited to, catalog, reference and symbol data.
Users should verify for themselves that the data is accurate and suitable for their project work.
Trademarks
Intergraph, the Intergraph logo, PDS, SmartPlant, SmartMarine, FrameWorks, I-Convert, I-Export, I-Sketch, IntelliShip, INtools,
ISOGEN, MARIAN, SmartSketch, SPOOLGEN, SupportManager, and SupportModeler are trademarks or registered trademarks
of Intergraph Corporation or its subsidiaries in the United States and other countries. Microsoft and Windows are registered
trademarks of Microsoft Corporation. MicroStation is a registered trademark of Bentley Systems, Inc. Other brands and product
names are trademarks of their respective owners.
Contents
Preface .......................................................................................................................................................... 5
SmartPlant Enterprise Control Panel documentation ............................................................................. 5
Infrastructure ............................................................................................................................................. 13
Index ........................................................................................................................................................... 25
User's guide
SmartPlant Enterprise Control Panel User's Guide - Provides information and instructions to
help new users manage information in SmartPlant Enterprise Control Panel.
Customer support
For the latest support information for this product, use a World Wide Web browser to connect to
http://support.intergraph.com (http://support.intergraph.com).
Send documentation comments or suggestions to PPMdoc@intergraph.com.
Security model
The SmartPlant Foundation security model is a flexible mechanism to control role-based user
access to data and the operations that can be performed on that data. The security model is
comprised of:
Users
Roles, domains, and access groups
Configurations
Role assignments
A user is assigned a role in a configuration. Roles are related to access groups, which control
access to the different components of the system. The security model also controls user access
to:
Menus and toolbars
Shortcut menu commands
Relationship manipulation and navigation
The SmartPlant Foundation Desktop Client is used to configure the security model by creating
and relating security objects. No additional schema modeling of classes, interfaces, or
relationship definitions is required.
Once the security access model is designed, the various levels of access are modeled by
creating access groups and relating them to roles. The access groups are related to the relevant
methods, interfaces, and view definitions, to which they have to grant access.
SmartPlant Enterprise Control Panel is delivered with several default roles, access groups, and
configurable GUI items that are loaded with the default SmartPlant Enterprise Control Panel
administrative files.
For more information on configurable GUI items, see Update and Configure Items on the
SmartPlant Enterprise Control Panel Interface in the SmartPlant Enterprise Control Panel
Administration and Configuration Guide.
To configure SmartPlant Enterprise Control Panel security, you must create users, configure the
users' roles, then assign or relate each new user to access groups using the SmartPlant
Foundation Desktop Client.
The SmartPlant Foundation How to Configure the Security Model guide describes the
configuration and components of the SmartPlant Foundation security model. You can access
the guide by clicking Help > Printable Guides.
Role assignments
SmartPlant Enterprise Control Panel is delivered with five default roles:
Role Description
SPE_Viewer View-only access to SmartPlant Enterprise Control Panel data.
SPE_Administrator Permissions to view, modify, update data, and perform
administrative tasks in SmartPlant Enterprise Control Panel.
SPE_2DEditor Permissions to edit 2D map files, such as SmartPlant P&ID. 3D
tool data can be seen but is not editable.
SPE_3DEditor Permissions to edit 3D map files, such as for SmartPlant 3D. 2D
tool data can be seen but is not editable.
SPE_SPFEditor Permissions to edit SmartPlant Foundation map files, such as
for Plant Breakdown Structure (PBS). All other tool data can be
seen but is not editable.
The role assignment links a user to a role in a given configuration.
By default, all SmartPlant Enterprise Control Panel roles are managed by the
SmartPlant Enterprise Control Panel Administrator role.
For more information about creating roles, assignments and configuration, see the SmartPlant
Foundation How to Configure the Security Model guide.
User access
SmartPlant Enterprise Control Panel is delivered with five example users:
User Role
SPEViewer SmartPlant Enterprise Control Panel
Viewer.
SPEAdmin SmartPlant Enterprise Control Panel
Administrator.
SPE2DEditor Editor of 2D Map Files.
SPE3DEditor Editor of 3D Map Files.
SPESPFEditor Editor of SmartPlant Foundation Map
Files.
The role assignment links a user to a role in a given configuration.
For more information about role creation, assignments, and configuration, see SmartPlant
Foundation User Creation and User and Role Assignment Configuration in the SmartPlant
Foundation How to Configure the Security Model guide.
Access groups
Access groups govern user access to SmartPlant Enterprise Control Panel commands and
navigation, and are modeled to represent different levels of functional access. The SmartPlant
Foundation administrator assigns users to an access user group set up for SmartPlant
Enterprise Control Panel. The access user group to which a user is assigned dictates how that
user views and manages tool mapping data.
To grant a user permission to access a specific command or function, you must associate that
user's roles to the appropriate access group. The following access groups are delivered in
SmartPlant Enterprise Control Panel.
Access Group
Access Group Role SPE_Administrator Role SPE_Viewer
Description
SPEAdmin YES
SPEViewer YES YES
Access Group Access Group SPEM SPEL P&ID SPI 3D LLA PBS
Description
SPE2DEditor YES YES YES YES
SPE3DEditor YES
SPESPFEditor YES YES
To configure access groups, you need to log on to the SmartPlant Foundation Desktop Client as
an administrator.
These are the default access groups delivered with the Sample Data SPE Map Tool
Templates. If you do not load the sample data, then the access groups in this chart do not exist.
For more information, see Roles and Access Groups in the SmartPlant Foundation How to
Configure the Security Model guide.
Infrastructure
In SmartPlant Enterprise Control Panel, the infrastructure refers to the items and configuration
that support the SmartPlant Enterprise Control Panel software, as connected to the SmartPlant
Foundation software.
For detailed information about configuring SmartPlant Foundation infrastructure and the
infrastructure model, see How to Configure the Infrastructure Model delivered with SmartPlant
Foundation.
4. In the New SmartPlant Enterprise Control Panel Site dialog box, select a site to update
from the list, or type a new site name, and click Create.
The site node is added under the SmartPlant Enterprise Control Panel Sites. All
server DLLs are installed on the site and configuration XML files are updated.
After creating the new SmartPlant Enterprise Control Panel site, close SmartPlant
Foundation Server Manager and recycle the Internet Information Services (IIS) application
pools for your project's site.
a. At the command prompt, type
%WINDIR%\Microsoft.NET\Framework64\v4.0.30319 to go to the .NET
Framework 4 64bit folder.
b. Type the commands:
aspnet_regiis-iru
iisreset
You must reset IIS when installing a new site to avoid errors.
After installing the server DLLs and updating the configuration XML files, perform a backup of
your SmartPlant Foundation database. For more information on backing up your database, see
the SmartPlant Enterprise Backup and Restore Guide delivered with SmartPlant Foundation.
Loading data
As a SmartPlant Enterprise Control Panel system administrator, you can view and edit mapping
dataflow and administrative information from the SmartPlant Foundation database. You can also
use the report commands to extract data and administrative information from the system.
The Loader functionality allows you to import data and configuration information into the
SmartPlant Foundation database for viewing in SmartPlant Enterprise Control Panel.
For more detailed information about loading and importing data into the SmartPlant Foundation
database, see the How to Set Up and Configure SmartPlant Foundation Guide delivered with
SmartPlant Foundation.
In order to make the flow of selecting publishable and retrievable tools better, Intergraph
recommends that you relate the tool object to other tool objects for publish and retrieve.
For the first release of SmartPlant Enterprise Control Panel this conversion is done in
SmartPlant Foundation.
New tool signatures are created when a new tool application registers with
SmartPlant Foundation.
4. Right-click the new tool signatures in the list view.
The user's DefaultAppPool will need to be given appropriate permissions on this local
directory.
Appropriate permissions must be given to the users and groups who access the files.
2. Store the map files in a remote directory on the same network domain as the SmartPlant
Enterprise Control Panel server computer.
3. Share this directory with the appropriate permission to allow the integration tools access to
the map files.
In order for the SmartPlant Enterprise Control Panel server to be able to edit the map
files, the security on the map file directory must be set up to give appropriate permissions to the
domain account for the SmartPlant Enterprise Control Panel server. The Network Service user
also has to be given permissions on the system Temp directory to cache some files. For
example, c:\windows\temp.
To use this new localization assembly with the correct language localized strings, copy the
directory into the executable directory of the component. For the SmartPlant Enterprise Control
Panel client, this is the directory where the SPEClient.exe is located. For the SmartPlant
Enterprise Control Panel server, this is the virtual directory where the SPE.Server.dll is being
used.
The translated resource file must be located in a sub directory with the name of the culture
for which it has been generated, such as en for English
A list of standard language and culture codes supported by this utility can be located at:
http://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo%28v=vs.71%29.asp
x
(http://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo%28v=vs.71%29.as
px)
A prerequisite for using this utility is that you have the Microsoft Windows SDK installed on
the computer you are using, to make use of the assembly linker tool. The Windows SDK is
available for download from the Microsoft website:
http://msdn.microsoft.com/en-us/library/hh272952.aspx
(http://msdn.microsoft.com/en-us/library/hh272952.aspx)
A W
Access groups • 11 Welcome to SmartPlant® Enterprise
Control Panel • 7
C
Configuring Remote Map File Directories •
21
Configuring SmartPlant Enterprise Control
Panel in Server Manager • 15
Convert registered tools into tool objects •
19
Converting Registered Tools into Tool
Objects • 19
Create a New SmartPlant Enterprise
Control Panel Site in Server Manager •
15
E
Enterprise Dataflow Module • 7
G
Generating Localized Resource Assemblies
• 23
I
Infrastructure • 13
L
Loading data • 17
P
Plants and projects • 13
Preface • 5
R
Role assignments • 10
S
Security model • 9
U
User access • 10