Citrix

Plant Mode Guide

Version 2014 (10.0)

September 2013
DSP3D-PE-200091E

Copyright
Copyright 2009-2013 Intergraph Corporation. All Rights Reserved. Intergraph is part of Hexagon.
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.
Portions of this software are owned by Spatial Corp. 1986-2013. All Rights Reserved.
Portions of the user interface copyright 2012-2013 Telerik AD.

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
300 Intergraph Way
Huntsville, AL 35813

Documentation
Documentation shall mean, whether in electronic or printed form, User's Guides, Installation Guides, Reference Guides,
Administrator's Guides, Customization Guides, Programmer's Guides, Configuration Guides and Help Guides delivered with a
particular software product.

Other Documentation
Other Documentation shall mean, whether in electronic or printed form and delivered with software or on eCustomer, SharePoint, or
box.net, any documentation related to work processes, workflows, and best practices that is provided by Intergraph as guidance for
using a software product.

Terms of Use
a.

Use of a software product and Documentation is subject to the End User License Agreement ("EULA") delivered with the
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 and Documentation. 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.

b.

For use of Documentation or Other Documentation where end user does not receive a EULA or does not have a valid license
agreement with Intergraph, Intergraph grants the Licensee a non-exclusive license to use the Documentation or Other
Documentation for Licensees internal non-commercial use. Intergraph Corporation gives Licensee permission to print a
reasonable number of copies of Other Documentation for Licensees internal, non-commercial. The Other Documentation may
not be printed for resale or redistribution. This license contained in this subsection b) may be terminated at any time and for any
reason by Intergraph Corporation by giving written notice to Licensee.

Disclaimer of Warranties
Except for any express warranties as may be stated in the EULA or separate license or separate terms and conditions, Intergraph
Corporation disclaims any and all express or implied warranties including, but not limited to the implied warranties of merchantability
and fitness for a particular purpose and nothing stated in, or implied by, this document or its contents shall be considered or deemed
a modification or amendment of such disclaimer. 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, Documentation and Other Documentation discussed in this document are furnished under a license and may be used
or copied only in accordance with the terms of this license. 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.

Limitation of Damages
IN NO EVENT WILL INTERGRAPH CORPORATION BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL INCIDENTAL,
SPECIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO, LOSS OF USE OR PRODUCTION, LOSS OF

Citrix Plant Mode Guide

REVENUE OR PROFIT, LOSS OF DATA, OR CLAIMS OF THIRD PARTIES, EVEN IF INTERGRAPH CORPORATION HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
UNDER NO CIRCUMSTANCES SHALL INTERGRAPH CORPORATIONS LIABILITY EXCEED THE AMOUNT THAT
INTERGRAPH CORPORATION HAS BEEN PAID BY LICENSEE UNDER THIS AGREEMENT AT THE TIME THE CLAIM IS
MADE. EXCEPT WHERE PROHIBITED BY APPLICABLE LAW, NO CLAIM, REGARDLESS OF FORM, ARISING OUT OF OR IN
CONNECTION WITH THE SUBJECT MATTER OF THIS DOCUMENT MAY BE BROUGHT BY LICENSEE MORE THAN TWO (2)
YEARS AFTER THE EVENT GIVING RISE TO THE CAUSE OF ACTION HAS OCCURRED.
IF UNDER THE LAW RULED APPLICABLE ANY PART OF THIS SECTION IS INVALID, THEN INTERGRAPH LIMITS ITS
LIABILITY TO THE MAXIMUM EXTENT ALLOWED BY SAID LAW.

Export Controls
Intergraph Corporations software products and any third-party Software Products obtained from Intergraph Corporation, its
subsidiaries, or distributors (including any Documentation, Other Documentation or technical data related to these products) are
subject to the export control laws and regulations of the United States. Diversion contrary to U.S. law is prohibited. These Software
Products, and the direct product thereof, must not be exported or re-exported, directly or indirectly (including via remote access)
under the following circumstances:
a.

To Cuba, Iran, North Korea, Sudan, or Syria, or any national of these countries.

b.

To any person or entity listed on any U.S. government denial list, including but not limited to, the U.S. Department of Commerce
Denied Persons, Entities, and Unverified Lists, http://www,bis.doc.gov/complianceandenforcement/liststocheck.htm, the U.S.
Department of Treasury Specially Designated Nationals List,
www.treas.gov/offices/enforcement/ofac/http://www.pmddtc.state.gov/compliance/debar.html, and the U.S. Department of State
Debarred List.

c.

To any entity when Licensee knows, or has reason to know, the end use of the Software Product is related to the design,
development, production, or use of missiles, chemical, biological, or nuclear weapons, or other un-safeguarded or sensitive
nuclear uses.

d.

To any entity when Licensee knows, or has reason to know, that an illegal reshipment will take place.

Any questions regarding export or re-export of these Software Products should be addressed to Intergraph Corporations Export
Compliance Department, Huntsville, Alabama 35894, USA.

Trademarks
Intergraph, the Intergraph logo, PDS, SmartPlant, FrameWorks, I-Convert, I-Export, I-Sketch, SmartMarine, IntelliShip, INtools,
ISOGEN, MARIAN, SmartSketch, SPOOLGEN, SupportManager, SupportModeler, and Intergraph Smart 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. ACIS is a registered trademark of SPATIAL TECHNOLOGY, INC. Infragistics,
Presentation Layer Framework, ActiveTreeView Ctrl, ProtoViewCtl, ActiveThreed Ctrl, ActiveListBar Ctrl, ActiveSplitter,
ActiveToolbars Ctrl, ActiveToolbars Plus Ctrl, and ProtoView are trademarks of Infragistics, Inc. Incorporates portions of 2D DCM,
3D DCM, and HLM by Siemens Product Lifecycle Management Software III (GB) Ltd. All rights reserved. Gigasoft is a registered
trademark, and ProEssentials a trademark of Gigasoft, Inc. VideoSoft and VXFlexGrid are either registered trademarks or
trademarks of ComponentOne LLC 1991-2013, All rights reserved. Oracle, JD Edwards, PeopleSoft, and Retek are registered
trademarks of Oracle Corporation and/or its affiliates. Tribon is a trademark of AVEVA Group plc. Alma and act/cut are trademarks of
the Alma company. Other brands and product names are trademarks of their respective owners.

Citrix Plant Mode Guide

Citrix Plant Mode Guide

Contents
Preface ................................................................................................................................................... 7
Documentation Set ............................................................................................................................ 7
Documentation Comments............................................................................................................... 10
What's New with Citrix Integration .................................................................................................... 10
Smart 3D and Citrix.............................................................................................................................. 11
Installation of SmartPlant License Manager ....................................................................................... 13
Microsoft Windows Firewall and SmartPlant License Manager ......................................................... 15
SmartPlant License Manager and Citrix ........................................................................................... 16
Client/Workstation Setup..................................................................................................................... 19
Loading Prerequisite Software on the Client ..................................................................................... 19
Install Microsoft .NET Framework (Database Server) ................................................................. 19
Install Microsoft XML 6.0 ........................................................................................................... 19
Install Microsoft Office ............................................................................................................... 20
Installing Microsoft SQL Server 2008 Client ..................................................................................... 20
Register SQL Server 2008......................................................................................................... 22
Installing and Configuring Oracle Client Software ............................................................................. 23
Install Oracle 32-bit Client Software 11g Release 2 .................................................................... 24
Configure the Oracle Client........................................................................................................ 25
Verify Startup of Oracle Client Services ..................................................................................... 26
Install Smart 3D Client Software ...................................................................................................... 26
Configure for an Integrated Environment ................................................................................... 28
Register Solid Edge .DLL File .................................................................................................... 29
Instructions for Windows 2008 Server ................................................................................................ 31
Deploying SmartPlant Enterprise on Citrix......................................................................................... 33
Set Up the Citrix License Server ...................................................................................................... 33
Set Up the Citrix XenApp 6.5 Server ................................................................................................ 33
Publish Applications on the Application Delivery Server ................................................................... 34
Install the Application on the Application Delivery Server ........................................................... 34
Publish the Application on the Application Delivery Server ......................................................... 35
Additional Citrix Implementation Topics ............................................................................................ 37
Adding Application Path Statements to the System Path .................................................................. 37
Configuring Dual Monitors................................................................................................................ 39
Citrix Client Time Zones ................................................................................................................... 40
Disable the Citrix Virtual Memory Optimizer ..................................................................................... 40
Index ..................................................................................................................................................... 43

Citrix Plant Mode Guide

Contents

Citrix Plant Mode Guide

Preface
This document describes how to install, configure, and use Intergraph SmartTM 3D on Citrix
XenApp 6.5.

Documentation Set
TM

Intergraph Smart 3D documentation is available as Adobe PDF files. The content is the same
as the online Help. To access these PDF documents, click Help > Printable Guides in the
software.
The documentation set is divided into four categories:
Administrative guides contain information about installing, configuring, customizing, and
troubleshooting.
User's guides provide command reference and how-to information for working in each task.
Reference data guides define the reference data workbooks. Not all tasks have reference
data.
ISOGEN guides.

Administrative Guides
Intergraph SmartTM 3D Installation Guide - Provides instructions on installing and configuring the
software.
Project Management User's Guide - Provides instructions for setting up the databases, creating
permission groups, backing up and restoring project data, assigning access permissions to the
model, defining and managing locations for Global Workshare, and version upgrade.
Global Workshare Guide - Provides instructions for setting up the software and the databases to
work in a workshare environment.
Interference Checking Guide - Provides information on installing, configuring, and using the
interference detection service.
Integration Reference Guide - Provides information about installing, configuring, and using
Smart 3D in an integrated environment.
Interpreting Human Piping Specifications - Provides information about how to interpret human
piping specifications so that you can create the corresponding piping specification in the
software.
Export to PDMS - Provides information about how to export model data from Smart 3D to
PDMS. Specific guidelines relating to best practices and known limitations of the export
functionality are also included.
Point Cloud Reference - Provides information for referencing point cloud files provided by point
cloud vendors in Smart 3D.
Troubleshooting Reference Guide - Provides information on how to resolve errors that you might
encounter in the software by documenting troubleshooting tips, error messages, and To Do List
messages.
Plant Design System (PDS) Guide - Provides all information needed to use PDS with Smart 3D.
Topics include referencing active PDS projects in Smart 3D, exporting PDS data and importing
that data into Smart 3D, and converting PDS reference data to Smart 3D reference data.

Citrix Plant Mode Guide

Preface
TM

Intergraph Smart 3D Programmer's Guide - Provides information about custom commands,

naming rules, and symbol programming. If you install the Programming Resources, this
document is delivered to the [Product Folder]\Programming\Help folder.

User's Guides
Catalog User's Guide - Provides information about viewing, editing, and creating reference data
and select lists (codelists).
Common User's Guide - Provides information about defining workspaces, manipulating views,
and running reports.
Compartmentation User's Guide - Provides instruction for placing volume objects such as
compartments and zones in the model.
Electrical User's Guide - Provides information about routing electrical cable, cableway, cable
tray, and conduit.
Equipment and Furnishings User's Guide - Provides information about placing equipment.
Geometry Analysis and Repair User's Guide - Provides instructions for importing and exporting
model data, checking the data against a defined set of requirements, and repairing the data.
Grids User's Guide - Provides instructions for creating coordinate systems, elevation grid
planes, vertical grid planes, radial cylinders, radial planes, grid arcs, and grid lines.
Hangers and Supports User's Guide - Provides instructions on placing piping, duct, and
cableway supports in the model.
Hole Management User's Guide - Provides instructions for placing, reviewing, and approving
holes in a structure.
HVAC User's Guide - Provides instructions for routing HVAC duct.
Molded Forms User's Guide - Provides instructions for placing hull, bulkheads, major openings,
stiffeners, and other major structural components in the model.
Orthographic Drawings User's Guide - Provides information about creating and managing
orthographic drawings.
Piping Isometric Drawings User's Guide - Provides information about creating and managing
piping isometric drawings.
Piping User's Guide - Provides instructions for routing pipe and placing valves, taps, and pipe
joints.
Planning User's Guide - Provides instructions about defining the assembly hierarchy (production
bill of material) by creating blocks and assemblies and by specifying the assembly sequence.
Reports User's Guide - Provides information about creating and managing spreadsheet reports.
Space Management User's Guide - Provides instructions for placing space objects such as
areas, zones, interference volumes, and drawing volumes in the model.
Structural Analysis User's Guide - Provides instructions for defining loads, load cases, load
combinations, and the importing and exporting of analytical data.
Structural Detailing User's Guide - Provides instructions for creating, detailing, and maintaining
the structural members of a model.
Structural Manufacturing User's Guide - Provides instructions for creating and maintaining
manufacturing objects such as templates, jigs, and margins.
Structure User's Guide - Provides instructions for placing structural members, such as beams,
columns, slabs, openings, stairs, ladders, equipment foundations, and handrails.
Systems and Specifications User's Guide - Provides instructions for creating systems and
selecting the available specifications for each system type.

Citrix Plant Mode Guide

Preface
Reference Data Guides
2D Symbols User's Guide - Provides command reference information and procedural
instructions for creating 2D symbols used to represent collars, clips, profiles, brackets, and other
items.
2D Symbols Reference Data Guide - Provides information about the two-dimensional symbols
used in all tasks.
Compartmentation Reference Data Guide - Provides information about compartmentation
reference data.
Drawings and Reports Reference Data Guide - Provides information about reports reference
data.
Electrical Reference Data Guide - Provides information about electrical cable, cableway, cable
tray, and conduit reference data.
Electrical 3D Symbols Reference - Provides information about the cable tray and conduit 3D
symbols that are available.
Equipment and Furnishings Reference Data Guide - Provides information about equipment
reference data.
Equipment 3D Symbols Reference - Provides information about the equipment, equipment
component, design shapes, and design aides 3D symbols that are available.
Hangers and Supports Reference Data Guide - Provides information about hangers and
supports reference data.
Hangers and Supports 3D Symbols Reference - Provides information about the hanger and
support 3D symbols that are available.
Hangers and Supports SmartPart Symbols Reference - Provides information about the hanger
and support SmartPart symbols that are available.
Hole Management Reference Data Guide - Provides information about hole reference data.
HVAC Reference Data Guide - Provides information about HVAC reference data.
HVAC 3D Symbols Reference - Provides information about the HVAC 3D symbols that are
available.
Reference Data Guide - Provides instructions about the Bulkload utility, codelists, and the
reference data common to several disciplines.
Piping Reference Data Guide - Provides information about piping reference data including piping
specifications, piping specification rules, piping parts, and piping symbols.
Piping 3D Symbols Reference - Provides information about the piping 3D symbols that are
available.
Space Management Reference Data Guide - Provides information about space management
reference data.
Structure Reference Data Guide - Provides information about structural reference data.
Structure 3D Symbols Reference - Provides information about the stair, ladder, footings, and
equipment foundation 3D symbols that are available.
Structural Reference Data Overview - Provides an overview of the marine mode structural
reference data library.

ISOGEN Guides
Symbol Keys Reference Guide - Provides information about the symbol keys for isometric
drawings. This guide is from Alias, the makers of ISOGEN.

Citrix Plant Mode Guide

Preface

Documentation Comments
We welcome comments or suggestions about this documentation. You can send us an email at:
PPMdoc@intergraph.com.
Documentation updates for supported software versions are available from eCustomer
https://crmweb.intergraph.com.

What's New with Citrix Integration

The following changes have been made to Citrix integration with Intergraph SmartTM 3D.
Version 2014 (10.0)
Added instructions for Windows 2008 Server. For more information, see Instructions for
Windows 2008 Server (on page 31). (P3 CP:225278)
Added instructions for installing Microsoft .NET Framework (Database Server). For more
information, see Install Microsoft .NET Framework (Database Server) (on page 19). (P3
CP:225278)

10

Citrix Plant Mode Guide

SECTION 1

Smart 3D and Citrix

TM

Intergraph Smart 3D can be setup to run with Citrix XenApp 6.5. This document contains
information you will need to install and configure SmartPlant License Manager and Smart 3D.

Citrix Plant Mode Guide

11

Smart 3D and Citrix

12

Citrix Plant Mode Guide

SECTION 2

Installation of SmartPlant License

Manager
Before beginning the product installation, refer to the delivered SmartPlant License Manager
readme file for the latest product installation updates. The readme file is delivered in the top
level product folder of the product media. Be sure you have the latest version of the SmartPlant
License Manager software before beginning the installation. If you do not have the latest version
of the software, you can install it using http://ppmapps.intergraph.com/elicense
(http://ppmapps.intergraph.com/elicense).
SmartPlant License Manager 2010 (v11) can be upgraded to SmartPlant License
Manager 2012 (v12). Any existing license key will be invalidated after the upgrade to SmartPlant
License Manager 2012 (v12). You will also need to generate a new computer ID and request a
new key. If you upgrade the SmartPlant License Manager 2010 (v11) license computer to a
SmartPlant License Manager 2012 (v12) client by mistake, you will have to un-install the
SmartPlant License Manager client and reinstall SmartPlant License Manager 2012 (v12)
license computer.

Hardware Configurations
The SmartPlant License Manager licensing computer software should be installed on a stable,
single node, hardware configuration (such as a simple PC), with a static IP address, because
license key installation and license seat usage authentication depends on the information
gathered from the physical hardware. Any automated changes that cause the hardware
information not to match with the information used to generate the license key will result in a
failure of the authentication process.
Virtual (including VMware), shadowed, mirrored, dynamic, or distributed hardware
configurations cannot be used as a SmartPlant License Manager licensing computer. This
includes terminal (application) servers, networked and distributed storage management
systems, and so forth. When these specialized systems occur in the user's network, the
SmartPlant License Manager Server licensing computer should be installed on a separate
dedicated hardware configuration system. The SmartPlant License Manager licensing computer
should be situated on the user's network where it can be accessed by all systems that are
running application software that relies on the SmartPlant License Manager licensing computer
for license management.
Multiple SmartPlant License Manager licensing computers can be used in the user's network as
long as each system is a unique hardware system/installation. If SmartPlant License Manager
licensing computers are cloned after the license key has been installed, then the license
management will fail on the cloned system. Each SmartPlant License Manager licensing
computer requires its own unique license key.

RAID (redundant array of independent disks) and SAN (storage area networks) are not
supported on a SmartPlant License Manager license computer.
The license computer must have the same version (or later) of SmartPlant License Manager
installed as any client computers. In other words, you cannot use a newer version on a client
computer to retrieve a license from an older version of SmartPlant License Manager on the

Citrix Plant Mode Guide

13

Installation of SmartPlant License Manager

licensing computer. The license computer must have the same version (or a newer version)
installed than the clients.
You must log in as Administrator to install this software.
1. Insert the Intergraph SmartPlant License Manager media. If the media does not start
automatically, double-click Setup.exe in the root folder of the media.

2.
3.
4.
5.

During SmartPlant License Manager installation automatically turns on a product

usage log file in C:\Win32App\Ingr\SPLM\bin\loggingfileV12.txt. You can
change this location and name of this file as it can grow to be a large file. If you stop and
restart logging, you need to define the output location.
This file can grow very large and users can redefine the location and name of this file.
Select SmartPlant License Manager Installation.
Click Next on the Welcome to the InstallShield Wizard for SmartPlant License Manager
page.
Enter your name and company name in the User Name and Company Name fields on the
Customer Information page. Click Next.
On the Software License Agreement page, select your country from the list and click
Display to view the license agreement.

The license agreement is delivered as a PDF file.

6. Carefully read the license agreement. Close the PDF document, and click Yes on the
License Agreement page to accept the terms.
7. Select either License Client or License Machine.
8. On the Choose Destination Location page, click Next to install SmartPlant License
Manager in the default location. If you want to install the software in another location, click
Change and select the new location.
It is recommended that you install SmartPlant License Manager using a path that
contains no spaces, such as c:\win32app\Ingr (the default path).
9. Click Install on the Ready to Install the Program page. A status bar displays the progress
of the installation on the Status Setup page.
10. Click Finish on the InstallShield Wizard Complete page to complete installation of
SmartPlant License Manager.
Do not delete any files that are created during installation or as a result of using
SmartPlant License Manager. Removal of any files causes the license system to fail and
can require install, repair, or possibly removal and re-install of SmartPlant License Manager.
11. Add pdlice.exe to both the license computer and the client computer after installing of
SPLM. You may need to remove pdlice.exe and re-add it if you uninstall and reinstall
SPLM to upgrade SPLM from previous version to a current version. Otherwise, you may
receive a Connection timed out error message when you start your application. You may
also see the same error in your scavenging log file.

14

Citrix Plant Mode Guide

Installation of SmartPlant License Manager

Microsoft Windows Firewall and SmartPlant License

Manager
SmartPlant License Manager utilizes Transmission Control Protocol (TCP) ports to pass license
seats from the SmartPlant License Manager license machine(s) to the workstation(s). TCP port
807 is required to be open and is utilized by the SmartPlant License Manager license machine
to listen for requests from the workstation(s) for a license seat. If a request is made, a random
TCP port is utilized to pass the seat from license machine to client.
Since a firewall is used to prevent unauthorized port access, SmartPlant License Manager has
problems working properly with a firewall. Most firewalls allow an Administrator to open ports to
prevent the firewall from interfering with softwares execution. Because SmartPlant License
Manager utilizes random ports, there is not a good way to do this unless the firewall also allows
softwares to be added to a software list to open ports required by the software.
If you close the application properly, the license used by the workstation is released back to the
pool of licenses available. Sometimes, when an application process is exited abnormally, the
license seat is not returned to the license manager. This is where the SmartPlant License
Manager license machine can help. A scavenge routine can be setup to run that will scavenge
the network for seats that are reserved. If one is found, the seat can be returned to the pool if it
is no longer in use. The firewall prevents the license machine from retrieving the seat and
returns a timed out error message.
In order to run commands using the Command Prompt window, pdlice.exe needs to be
added to the Exception List for the Windows Firewall on both the license machine and the client
machine (if it is turned on). This includes all Windows operating system (for example, Microsoft
Windows 7, Windows Server 2008 R2, Windows Server 2003, Windows XP, and so forth). The
following steps provide an example of how to add the appropriate SmartPlant License Manager
software to the Exception List for Microsoft Windows 7 (allowing for proper scavenging and
access to the license machine).
1. Select Start > Control Panel > Windows Firewall to display the Windows Firewall options.
2. Click to select Allow a program or feature through Windows Firewall.
3. Click Change settings.
4. Click Allow another program.
5. Click Browse on the Add a Program dialog box.
6. Browse for the pdlice.exe software (by default it is installed in c:\win32app\ingr\splm\bin).
7. Click to select pdlice.exe and click Open.
8. Click Add on the Add a Program dialog box. SmartPlant License Manager now displays in
the Allowed programs and features list.
9. Click OK to dismiss the Windows Firewall options.
[Connecting Socket] Connection Time Out is the error message you receive if
pdlice.exe is not defined in the Windows Firewall exception list.

Citrix Plant Mode Guide

15

Installation of SmartPlant License Manager

SmartPlant License Manager and Citrix

Before you install any SmartPlant Enterprise software on a Citrix server, you must install and
configure the Citrix software and the corresponding prerequisites on the server. Please refer to
your Citrix documentation for more information about any prerequisites.
To run Smart 3D software on a Citrix server, you must install the same prerequisite software that
is required for the product to run on a desktop client system. Make sure that any patches or
prerequisite software installations are matched to the operating system. For example, a 64-bit
operating system may require that some patches or products are also 64-bit. All patches or
products should be in accordance with administrative guidance. For more information about
software prerequisites for SmartPlant Enterprise products, see the documentation delivered with
the product.

16

Only SmartPlant License Manager client is supported on a Citrix machine.

The SmartPlant License Manager license machine does not support a NAT configuration on
a Citrix machine.
Running batch jobs on the Citrix XenApp 6.5 server is not supported.
If you are using Citrix, and crossing multiple time zones, the error message SPLM
Failed: Server/Client Timers Mismatch by 6+ Hours - <license server> can display. To
correct the error, adjust the Citrix server's Time Zone Redirection configuration to prevent it
from using the client's local time zone for the Citrix session. For more information, refer to
the Citrix's Knowledge Base article Troubleshooting Client Time Zone Issues
(http://support.citrix.com/article/CTX303498).
If you have the license machine defined under HK_Current_User for SmartPlant License
Manager, you cannot use Test Seat Reservation and Test Seat Release (commands in the
SmartPlant License Manager product) to test the licensing machines. Those test options are
used to test for the licensing machine configured in the SmartPlant License Manager's
registry key (value from HK_Local_Machine in Registry).
A license machine that is defined in the HK_Current_User does not roll over to a license
machine defined using the SmartPlant License Manager interface (saved in
HKLM_Current_User).

Citrix Plant Mode Guide

Installation of SmartPlant License Manager

Additional information about certified Citrix versions is available on the SmartPlant Enterprise
Product Compatibility Matrix on the Intergraph Process, Power & Marine eCustomer Web site.
To view this matrix, browse to the following Web address, and type your eCustomer user name
and password: https://crmweb.intergraph.com. Click Download Software Updates >
Products, and then click the PPM Compatibility Matrices link in the middle of the page.
To install software on a Citrix server, you must log on with an account that has
administrator access. Use the Change User Mode Option to set the Terminal Server in the
"Installation" mode.

Hardware Requirements
Refer to your Citrix documentation for system hardware requirements for the Citrix server.
SmartPlant License Manager has no special hardware requirements beyond those
recommended for Windows.

Configure the SmartPlant License Manager Client on Citrix Server

SmartPlant License Manager listens for license requests on TCP port 807 (the port must be
open), and returns seat information over a randomly selected port. For more information, refer to
Appendix E: Microsoft Windows Firewall and SmartPlant License Manager.

Installing and Configuring the Product

Refer to Installation of SmartPlant License Manager (on page 13) for information about installing
and configuring SmartPlant License Manager. There are no special requirements for installing

Citrix Plant Mode Guide

17

Installation of SmartPlant License Manager

SmartPlant License Manager for use with Citrix. Configuring and installing SmartPlant License
Manager as a license machine on Citrix is not supported.

Publishing Smart 3D Applications

SmartPlant License Manager does not require any components to be published for user access.
Administrative access to the SmartPlant License software can be accomplished by publishing
the SmartPlant License Manager application in accordance with standard Citrix practices. Use
the provided Start > Intergraph SmartPlant License Manager menu for SmartPlant License
Manager as a guide for publishing the individual SmartPlant License Manager applications.

Known Issues
Configuring SmartPlant License Manager as a license machine on Citrix is not supported.

18

Citrix Plant Mode Guide

SECTION 3

Client/Workstation Setup
The Smart 3D client software is used for general modeling, as well as for performing a variety of
administrative activities, including managing permissions, backing up and restoring data,
creating plants, and monitoring database interference detection. Additionally, the software
provides features that extend the capabilities of the software to include importing model data
and integrating Smart 3D with SmartPlant P&ID.

If you have a previous version of Smart 3D installed, you need to remove it before installing
the new version. For more information, see Application Maintenance in the Intergraph
TM
Smart 3D Installation Guide.

Loading Prerequisite Software on the Client

The following prerequisite software is required in order to install and use the software on a client
computer:
Microsoft Office 2010 (32-bit)
Adobe Acrobat Reader
SmartPlant License Manager 2010 (V11.0) or 2012 (V12.0)

Install Microsoft .NET Framework (Database Server)

Stop any real-time virus checker before you start the installation. Virus checkers can interfere
with the installation.
1. Log on to the computer as an administrator.
2. Start Server Manager.
3. Select Features in the console tree.
4. Click Add Features in the Features Summary area.
The Add Features Wizard displays.
5. Select .NET Framework 3.5.1 Features from the list of available features.
6. Click Install, and follow the prompts.

Install Microsoft XML 6.0

To install Microsoft XML 6.0, open your web browser and go to the MSXML Developer Center
Web Site (http://msdn.microsoft.com/xml/). Follow the guidelines to click the appropriate link for
downloading MSXML 6.0 on the workstation computer.
1. When downloading is complete, double-click the setup file.
2. On the Welcome page, click Next.
3. On the End-User License Agreement page, click I accept the terms in the License
Agreement and click Next.
4. On the Customer Information page, type your name and organization and click Next.
5. On the Choose Setup Type page, click Install Now.
6. Click Finish on the Setup Complete page.

Citrix Plant Mode Guide

19

Client/Workstation Setup
See Also
Setting Up the Client (see "Client/Workstation Setup" on page 19)

Install Microsoft Office

Several of the tasks require Microsoft Office. Designers need Microsoft Excel to create reports
and system administrators rely on Excel to make changes to the reference data spreadsheets
and bulk load them into the Catalog database. The current release of the software supports
Office 2010 (32-bit).

The system language specified for Microsoft Office must be the same as the system
language specified by the operating system. For example, if your operating system language
is English, Microsoft Office must also be set to English.
If you choose to do a custom installation of Office, be sure to select the .NET Programming
Support for Excel, which is required for the Model Data Reuse command.
If running in a Citrix environment, the MSDN license key must be a VLM license key for
multiple users to run reports.

See Also
Loading Prerequisite Software on the Client (on page 19)

Installing Microsoft SQL Server 2008 Client

Because system configurations and individual company standards vary, use this section as a
checklist instead of step-by-step instructions for Microsoft SQL Server 2008 SP3. Please contact
Intergraph Customer Support for specific configuration questions.
You need Microsoft SQL Server 2008 Client if:
The computer is an administrative workstation.
You plan to run Project Management on the computer.
You do not need to install Microsoft SQL Server 2008 Client if:
The computer is used for general design work (piping, HVAC, and so forth).
You are using Oracle as your database provider.

20

Microsoft SQL Server 2008 SP3 requires XML 6.0 and will automatically install it as part of
the SQL Server 2008 Prerequisite installation.
There are internationalization considerations concerning the SQL Server collation settings
you specify that relate to reference data, using SmartPlant Enterprise integrated systems,
Global Workshare Configuration, multiple locales, backup/restore, reports, and upgrading to
future releases. Please contact Intergraph Customer Support for specific configuration
questions.
If a XenApp 6.5 local data store (farm) will be used, Microsoft SQL Server Client must be
installed before installing XenApp 6.5.

Citrix Plant Mode Guide

Client/Workstation Setup
1. Insert your SQL Server DVD and start the setup software.

2. From the Planning page, select System Configuration Checker to check for pre-requisite
applications as well as identify potential installation problems.
You may be asked to restart your computer if any pre-requisite applications were
installed.
3. Click Installation and select the New SQL Server stand-alone installation or add
features to an existing installation option.

4. As you go through the installation process, make sure you install the Setup Support Files
and review any Setup Support Rules that identify potential problems.
5. When you get to Feature Selection, select the client features that you want to include:
Client Tools Connectivity
Management Tools - Basic

Citrix Plant Mode Guide

21

Client/Workstation Setup

Management Tools - Complete

6.
7.
8.
9.

When you get to Installation Rules, make sure all operations have passed.
From Ready to Install, click Install.
When the installation has been completed, review the summary log file for any problems.
Before you use the software, you must register it. See Register SQL Server 2008 (on page
22).
10. Install any required service packs or upgrades for SQL Server 2008. See Install any
Required SQL Server 2008 Upgrades.

Register SQL Server 2008

You must register the database server on the workstation computer if the computer is used for:
administration tasks such a Project Management and creating or upgrading databases
running the Name Generator Service
running the Interference Checking Service

Registering Servers
1. Open SQL Server Management Studio.
2. Click View > Registered Servers.

22

Citrix Plant Mode Guide

Client/Workstation Setup
Registered Servers appear in the left tree view.

3. In the tree view, right-click Database Engine, and select New > Server Registration in the
shortcut menu.
The New Server Registration dialog box appears.
4. On the General tab, type or select the name of the server to register.
5. Click Save.
If you intend to use the server computer in a Global Workshare Configuration,
register the server with a fully qualified domain. For example, a server on the INGRPPO
domain named WORKFLOW5 must be registered as WORKFLOW5.INGRPPO.COM. For
more information about using workshare, see the Global Workshare User's Guide (SQL
Server), available from Help > Printable Guides in the software.
6. Exit Management Studio.

Installing and Configuring Oracle Client Software

Because system configurations and individual company standards vary, use this section as a
checklist instead of step-by-step instructions. Please contact Intergraph Customer Support for
specific configuration questions.

Smart 3D is a 32-bit application that uses the 32-bit Oracle Client even when loaded on a
64-bit client operating system.
Do not use the Oracle "light client" as it does not include some DLLs required by Smart 3D.
You do not need to install the Oracle Client if you are using Microsoft SQL Server as your
database provider.

See Also
Install Oracle 32-bit Client Software 11g Release 2 (on page 24)
Configure the Oracle Client (on page 25)
Verify Startup of Oracle Client Services (on page 26)

Citrix Plant Mode Guide

23

Client/Workstation Setup

Install Oracle 32-bit Client Software 11g Release 2

Installation of the full Oracle Client software is required for a workstation computer so that the
software can connect to the Oracle database. After the Oracle Client software is installed, you
will configure the software so that your computer can communicate with the Oracle database.
1. Select Custom on the Select Installation Type screen, and click Next.
2. Select a language in the Select Product Languages screen, and click Next.
3. Specify the Oracle Base location for the base folder and the Software Location for the
home folder by browsing to the location, and click Next.
4. On the Available Product Components screen, select the following components:
Oracle Database Utilities
SQL *Plus
Enterprise Manager Minimal Integration
Oracle Net
Oracle Connection Manager
Oracle ODBC Driver
Oracle Services for Microsoft Transaction Server
Oracle Administration Assistant for Windows
Oracle Counters for Windows Performance Monitor
Oracle Objects for OLE
Oracle Provider for OLE DB
Oracle Data Provider for .NET
5. Specify port number 2030 in the Specify port number field on the Oracle Services for
Microsoft Transaction Services screen, and click Next.
The software performs a prerequisite check before continuing.
6. Click Finish on the Summary screen.
A progress bar tracks the progress of the installation.
7. When installation is complete, you must install Patch 22.
Now that the Oracle Client is installed, you can configure the client. For more information, see
Configure the Oracle Client (on page 25).
For information on installing Oracle server software, see Installing and Configuring Oracle
TM
Server Software in the Intergraph Smart 3D Installation Guide.

See Also
Installing and Configuring Oracle Client Software (on page 23)

24

Citrix Plant Mode Guide

Client/Workstation Setup

Configure the Oracle Client

Client computers need to be configured before they can connect to an Oracle database. To
configure the client computer, you must first install Oracle Client software as outlined:
1. Start Oracle Net Manager.
2. Select the Service Naming node, Install Oracle 32-bit Client Software 11g Release 2 (on
page 24), and then click the green plus sign to start the Net Service Name Wizard.

3. Specify a Service Name.

4.
5.
6.
7.
8.
9.
10.

The Service Name must be the same on the server and client. You will need to
provide this net service name when creating databases, bulkloading and configuring
Workshare.
Select TCP/IP (Internet Protocol).
Specify the Host name (typically the network name of the database server computer) and
Port Number (default=1521) for your protocol settings.
Specify the Service Name and Connection Type.
Test the new service.
If the default test fails, click Change Login, type a valid username/password combination
and, retest the connection.
When the login test is successful, click Finish to close the wizard.
Click File > Save Network Configuration to save your new network service.

See Also
Installing and Configuring Oracle Client Software (on page 23)

Citrix Plant Mode Guide

25

Client/Workstation Setup

Verify Startup of Oracle Client Services

1. Open the Control Panel and double-click Administrative Tools.
2. Double-click Services.

3.
4.
5.
6.
7.

You can also right-click My Computer and select Manage. In the Computer
Management window, expand the Services and Applications node, and click Services.
Verify that the Status field is set to Started and the Startup Type field is set to Automatic,
for OracleMTSRecoveryService.
To change the Status or Startup Type fields, right-click the service name, and select
Properties from the shortcut menu.
On the General tab, select Automatic from the Startup type list.
In the Service status section, click Start.
Click OK.

See Also
Installing and Configuring Oracle Client Software (on page 23)

Install Smart 3D Client Software

Prior to installing Smart 3D on a workstation computer, verify that the workstation computer
meets the required hardware and software requirements and that all prerequisite software has
been installed. For more information, see Smart 3D Workstation Recommendations in the
TM
Intergraph Smart 3D Installation Guide. For more information about the prerequisite software,
see Loading Prerequisite Software on the Client (on page 19).
Remove the older version of Smart 3D before loading the new version. For more information,
TM
see Remove Smart 3D Software in the Intergraph Smart 3D Installation Guide.
You must have administrator privileges on the computer to install the software. We recommend
using the Run as Administrator option.
If you have not already installed and configured SmartPlant License Manager on your computer,
we recommend doing so before installing Smart 3D.
Smart 3D requires the SmartPlant License Manager software for concurrent
licensing for both the core Smart 3D product and for each module. This licensing software is
delivered on its own DVD that comes with your Smart 3D DVD. For more information about
using and configuring concurrent licensing, see the SmartPlant License Manager Installation
and User's Guide (SPLMInstall_UserGuide.pdf).
During setup, the %temp% value is defined as the user %temp% of the person who
runs the setup. In Windows, each user's C:\Documents and Settings\username\Local
Settings\Temp is protected from other Windows users. Consequently, you must set the system
environment variable TEMP value to a folder location where everyone has write access (for
example, c:\temp). For more information about editing system variables, see the Help and
Support Center (click Start > Help and Support Center from the Windows task bar).
1. Insert the Intergraph Smart 3D DVD. If the DVD does not start automatically, right-click
Setup.exe in the root folder of the DVD and select Run as administrator.
2. Click Additional Software, and the select the optional software that you need to install, if
any:
Install SmartPlant Schema Component
Install PDS Export Tools
Install PDS Data Access

26

Citrix Plant Mode Guide

Client/Workstation Setup
3. Click Back if needed.
4. Click Full Installation or Evaluation Installation based on your needs.
5. Read the license agreement. Click to agree to the Software License Agreement, and then
click Next.
6. Type your name or organization information.
7. Select the components to install on this computer:
Smart 3D Installation - Installs the Smart 3D client component that contains the
modeling tasks such as Common, Piping, Equipment, Structure, and so forth.
Project Management - Installs the Project Management client used for creating
models, managing access control, and upgrading databases. Select this option for
an administrator's computer. You must also install the Server Connectivity option
(below) and the Microsoft SQL Server client tools. The Microsoft SQL Server client
tools are not required on computers where Project Management is not installed or
if you are using Oracle as your database provider.
Bulkload Reference Data - Installs sample Microsoft Excel reference data
workbooks and the utilities needed to bulkload the workbooks into the Catalog task.
Select this option for people working with reference data and the Catalog task. You
must also install the Server Connectivity option if you select this option.
Piping Specification Remote Access Server - Installs the necessary software for
correlating piping specification data between Smart 3D and SmartPlant P&ID. This
option sets up the computer as a remote access server by registering the
SP3DPipingSpecRemoteAccessServer COM+ component. For more information
about the P&ID integration capabilities of the software, see Integrating with
TM
SmartPlant P&ID in the Intergraph Smart 3D Installation Guide.
Database Interference Detection Service - Installs the software required for
database interference detection. You must configure this service through Windows
Services. Requires the Project Management and the Server Connectivity
components. For more information, see Interference Checking Setup.
Server Connectivity - Installs required database connectivity components for
Project Management, the Bulkload Utility, Piping Specification Remote Access
Server, and the Database Interference Detection Service.
64-bit Services - Installs the 64-bit version of the Interference Checking and
Drawings Batch Services components.

64-bit Services cannot be uninstalled individually. You must remove all

of Intergraph Smart 3D from the computer to remove the 64-bit Services
component.
Smart 3D Layout Installation - Installs the Smart 3D Layout task (licensed-separately).
Smart 3D Layout is a route finding tool. The primary purpose is to find the minimum
installed cost route for the pipe. To do this a number of candidate routes are generated
for each routing requirement and the one with the lowest "Evaluation Cost" is returned
as the route solution.
Name Generator Installation - Installs the 32-bit version of the Name Generator. Install
this one if you are installing the Name Generator on a computer where the Oracle 32-bit
client is installed.
Name Generator 64-bit Installation - Installs the 64-bit version of the Name Generator.
Install this one if you are installing the Name Generator on a computer running a server
operating system, you are using Microsoft SQL Server, or you are installing on an
Oracle database server.

Citrix Plant Mode Guide

27

Client/Workstation Setup

For more information about which version of the Name Generator you need
and about the Name Generator in general, see Name Generator Service Setup.
Reference Data Installation - Installs the reference data needed to run Smart 3D. You
should pick one server on which to install the reference data. Do not install reference
data on each client or administrator computer. For more information, see Reference
Data Setup.
Smart 3D PDS Project Translators Installation - Installs the Smart 3D PDS Project
Translators (licensed-separately) component that further extends the PDS integration
capabilities by allowing you to export Piping, HVAC, Electrical, Equipment, and
Structure model data from PDS into Smart 3D. For more information, see Install Smart
3D PDS Project Translators.
Smart 3D Tribon Interface Installation - Installs the Smart 3D Tribon Interface
(licensed-separately) component that allows you to import Tribon Initial Design M3
structural data into Smart 3D in marine mode for planning and outfitting purposes. For
more information, see Smart 3D Tribon Interface Setup.
Programming Resources Installation - Installs the Programming Resources
component which provides developers with the tools necessary to customize the
software by creating custom commands or custom softwares. For more information, see
Programming Resources Setup.

Serial numbers are used for product identification only. A license key is
required to run the software. For more information about installing and using SmartPlant
License Manager, see the SmartPlant License Manager Installation and User's Guide
(SPLMInstall_UserGuide.pdf).
8. Click Install.
The selected options are installed on the computer.
9. Click Finish.

Configure for an Integrated Environment

Configuring Smart 3D to work in an integrated environment provides a platform for data
exchange, sharing, and integration across various software tools, enabling concurrent use and
rapid communication among all Smart 3D project participants. Critical information is stored only
once in a data-neutral warehouse, eliminating duplication and ensuring that timely, accurate
data is always available.
Two steps are required to take advantage of the Smart 3D integration functionality:
1. Install the SmartPlant Client and Schema Component on your Smart 3D workstation
computers, as necessary. For more information about installing Smart 3D components, see
the Integration Setup Guide, available in the SmartPlant Enterprise documentation set.
In order to take full advantage of the Smart 3D integration functionality, you
must install the SmartPlant Client and Schema Component on a Smart 3D workstation
computer on which the Project Management, Server Connectivity, and Piping
Specification Remote Access Server options are installed.
2. Use the Project Management task to register your Smart 3D model. For more information
about registering models, see the Project Management User's Guide, available from Help >
Printable Guides.

28

Citrix Plant Mode Guide

Client/Workstation Setup

Register Solid Edge .DLL File

While not a prerequisite, Solid Edge can be used with Smart 3D. For optimum performance,
install Solid Edge prior to running the Smart 3D software setup. In the event that Solid Edge is
installed after Smart 3D, you will need to manually register the Pvdt80.ocx file.
Additionally, if you uninstall or reinstall either Smart 3D or Solid Edge from the workstation
computer, use the steps outlined in the following procedure to manually register the Pvdt80.ocx
file.
You must have administrator privileges for the workstation computer on which you
want to register the file.
1. Open Windows Explorer. On the Windows task bar, right-click on Start and select Explore.
2. Browse to [INSTALLDIR]\Smart3D\Core\Register and double-click RegisterPvtd80.vbs to
register the Pvdt80.ocx file on your computer.

Citrix Plant Mode Guide

29

Client/Workstation Setup

30

Citrix Plant Mode Guide

SECTION 4

Instructions for Windows 2008 Server

Intergraph supports database servers with 64-bit Windows Server 2008 R2 Enterprise edition
with service pack 1. For more information on installation, see "Smart 3D Database Server
TM
Recommendations" in the Intergraph Smart 3D Installation Guide.

Citrix Plant Mode Guide

31

Instructions for Windows 2008 Server

32

Citrix Plant Mode Guide

SECTION 5

Deploying SmartPlant Enterprise on

Citrix
To deploy SmartPlant Enterprise software on Citrix, the following high-level procedure must be
performed:
1. Set Up the Citrix License Server (on page 33)
2. Set Up the Citrix XenApp 6.5 Server (on page 33)
3. Publish Applications on the Application Delivery Server (on page 34)

Set Up the Citrix License Server

A Citrix License Server must be installed on the network to run the Citrix XenApp server and to
publish applications. The License Server can reside on the same server computer as the
application publication server or on its own server.
1. Install prerequisite software on the License Server host computer.
Required software includes Internet Information Server (IIS), ASP.NET, and Terminal
Services. Refer to the Citrix product documentation for detailed requirements, including
required versions of each component.
2. Run the Citrix License Server installation wizard.

Set Up the Citrix XenApp 6.5 Server

The Citrix XenApp server must be installed and configured after the License Server has been
set up.
Perform the following procedure on the XenApp server.
1. Install prerequisite software on the XenApp host computer.
Required software includes Application Server, Internet Information Server (IIS),
ASP.NET, and Terminal Services. Refer to the Citrix product documentation for detailed
requirements, including required versions of each component.
2. Run the installation wizard for Citrix XenApp and its components.
In addition to installing the main Citrix XenApp component, the installation wizard also
installs the set of additional components selected at the beginning of the wizard, to include .NET
3.5 Service Pack 1.

Citrix Plant Mode Guide

33

Deploying SmartPlant Enterprise on Citrix

Publish Applications on the Application Delivery

Server
When installing applications on the application delivery server, you must perform the following
high-level procedure in order to ensure a successful implementation:
1. Run the installation for the application(s).
2. Publish the application using the Citrix AppCenter.

Install the Application on the Application Delivery Server

In a Citrix or Terminal Server environment the operating system has two user modes. The
normal execute mode and the installation mode. When installing applications in the
Installation mode changes that would be made in the Registry to HKEY_Current_User on a
single-user system are instead made to a shadow key for each user and files that would be
installed to a users home folder on a single-user system are saved to the %SystemRoot%
folder instead. The Installation mode of the Terminal Server operating system allows you to
install an application as if you were installing it on a single-user operating system.
To toggle these commands on the server use the following syntax: change user /install
(places the server in multi-user mode before loading applications). Change user /execute
(places the server back into normal execute mode). To see what mode the server is
currently in use: change user /query command.
If you are going to install Smart 3D silently with a script under a Terminal Services Server in
Application Server mode, we recommend that you update the script to include a Change
User mode command to set the user mode to Install mode first, and then back to Execute
mode after the Smart 3D installation command. This ensures that changes written to registry
key HKEY_CURRENT_USER are properly redirected to their corresponding
HKEY_LOCAL_MACHINE registry after each user logs in into the system. These steps are
also recommended when applying hot fixes and service packs in a silent install.
Most application installation softwares are detected by the Terminal Server and the change
to installation mode is done automatically. If this occurs, an After Installation window is
displayed, with the instruction to click Next after the installation. When Next is clicked, the
mode is set back to Execute mode, so it should not be done until the installation has
finished.
1. In a command prompt window, type change user /install and press Enter.
You can confirm the current setting of the user mode by using the /query switch
(change user /query).
2. Install any prerequisite software required by the application.
3. Run the installation for the application to be installed.
4. When the installation is complete, in the command prompt window, type change user
/execute and press Enter.

34

Citrix Plant Mode Guide

Deploying SmartPlant Enterprise on Citrix

Publish the Application on the Application Delivery Server

1. Launch the Citrix AppCenter.
If this is the first time Citrix AppCenter has been launched on this server, a wizard will
be launched to discover the server and load its properties into the console.
2. In the tree view, select Citrix Resources > XenApp > YourFarmName > Servers >
YourServerName.
3. Click the right mouse button on the server name and from the pop-up menu, select Other
Tasks > Publish application on the server.
4. Follow the prompts of the Publish Application wizard.

Citrix Plant Mode Guide

35

Deploying SmartPlant Enterprise on Citrix

36

Citrix Plant Mode Guide

SECTION 6

Additional Citrix Implementation Topics

The following topics contain additional configuration information related to publishing
applications on Citrix.

Adding Application Path Statements to the System

Path
Windows stores system path statements for individual executable files under the following
registry path (depending on the platform):
32-bit O/S: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\App
Paths\App_name.exe
64-bit O/S: HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\App
Paths\App_name.exe
When software registers an application path this way, Windows adds the path statement to the
search path whenever the application is run. This path information becomes part of the System
Search Path search order.
When applications are launched through Terminal Services (or Citrix), these path statements
are not automatically added. If an application requires this path, then the path information from
the appropriate AppPath registry key must be added to the path variable of the System
Environment.
Ensure that you back up the current value of the system path to a file for later
reference if there is an issue. Making a mistake during the modification of the system path
variable can render the computer unusable. It is essential to know the path contents prior to the
modification to bring the computer back with any real confidence if there is a problem.
1. In the Registry, copy the data of the Path value for the application executable:
32-bit O/S: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\App
Paths\App_name.exe
64-bit O/S: HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\App
Paths\App_name.exe

Citrix Plant Mode Guide

37

Additional Citrix Implementation Topics

2.
3.
4.
5.
6.

Display the System Properties window via the Control Panel.

Click the Advanced tab.
Click Environment Variables.
In the System variables list, select Path and click Edit.
Paste the value data from the Registry to the end of the Path string.

7. Click OK to dismiss all windows.

38

Citrix Plant Mode Guide

Additional Citrix Implementation Topics

Configuring Dual Monitors

After logging into the Citrix portal via the Citrix Web Client, perform the following procedure.
1. Select the Preferences menu on the title bar.

2. In the Display area of Session Settings, select the screen resolution to use.

Citrix Plant Mode Guide

39

Additional Citrix Implementation Topics

Citrix Client Time Zones

Please see the article How to Configure Time Zone Redirection in XenApp 6.x Using the
Windows Group Policy Management Editor (http://support.citrix.com/article/CTX126099). Citrix
relies on Microsoft APIs to establish time zone during an ICA session. Data is no longer written
to the user registry hive.

Disable the Citrix Virtual Memory Optimizer

A service named Virtual Memory Optimization (VMO) can inadvertently corrupt the .NET images
on the computer. When the application that relies on the image attempts to start, it cannot. It
terminates quickly with .NET errors reported to the event logs. The problem is transient because
the when the .NET optimizer service runs and the native images are processed and the
application works again. The application will work until the VMO kicks in again causing image
corruption.
To solve this problem, the Citrix Virtual Memory Optimizer (VMO) service needs to be set to
disabled. This is done as a FARM-WIDE policy in the Citrix AppCenter the .Net optimizer
should be set to Manual (which it is by default).
1. Stop the Citrix Virtual Memory Optimization service and set it to disabled.

40

Citrix Plant Mode Guide

Additional Citrix Implementation Topics

Computer Management >Services and Applications > Services > Citrix Virtual
Memory Optimization > Disabled.

Citrix Plant Mode Guide

41

Additional Citrix Implementation Topics

2. Disable the VMO service as a FARM-WIDE policy.
To repair the corrupt .NET images in place without removing and reinstalling software:
1. Complete the "Proactive" steps in the previous section: 1.) Stop the VMO service. And, 2.)
Disable the service as a FARM-WIDE Policy.
2. Open a command prompt to C:\windows\Microsoft.Net\framework64\ and run "ngen.exe
update" (Ignore any embedded errors many are expected. The process will take a few
minutes).
3. Open a command prompt to C:\windows\Microsoft.Net\framework\ and run "ngen.exe
update" (same-to-same).
This will fix .NET 3.5 and 3.0 and 1.1 images in addition to the 2.0 because the .NET
2.0 NGEN is the unified definition for all of these versions of .NET there is currently no
need to run NGEN for 3.0/3.5/1.1 just for 2.0. If 2.0 does not exist on the computer, then
the 3.0/3.5 NGEN(s) would work.

42

Citrix Plant Mode Guide

Index
A

Adding Application Path Statements to the

System Path 43
Additional Citrix Implementation Topics 43

Microsoft Windows Firewall and SmartPlant

License Manager 21

C
Citrix Client Time Zones 46
Client/Workstation Setup 25
Configure for an Integrated Environment
34
Configure the Oracle Client 31
Configuring Dual Monitors 45

D
Deploying SmartPlant Enterprise on Citrix
39
Disable the Citrix Virtual Memory Optimizer
46
Documentation Comments 13
Documentation Set 9

I
Install Microsoft .NET Framework
(Database Server) 25
Install Microsoft Office 26
Install Microsoft XML 6.0 26
Install Oracle 32-bit Client Software 11g
Release 2 30
Install Smart 3D Client Software 32
Install the Application on the Application
Delivery Server 40
Installation of SmartPlant License Manager
19
Installing and Configuring Oracle Client
Software 29
Installing Microsoft SQL Server 2008 Client
26
Instructions for Windows 2008 Server 37

P
Preface 7
Publish Applications on the Application
Delivery Server 40
Publish the Application on the Application
Delivery Server 41

R
Register Solid Edge .DLL File 35
Register SQL Server 2008 28

S
Set Up the Citrix License Server 39
Set Up the Citrix XenApp 6.5 Server 39
Smart 3D and Citrix 17
SmartPlant License Manager and Citrix 22

V
Verify Startup of Oracle Client Services 32

W
What's New with Citrix Integration 15

L
Loading Prerequisite Software on the Client
25

Citrix Plant Mode Guide

43