Citrix

Marine Mode Guide

Version 2014 (10.0)

Monday, September 02, 2013

DSHIP-PE-200092E

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 REVENUE

Citrix Marine Mode Guide

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 Marine Mode Guide

Citrix Marine 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
Install Smart 3D Client Software........................................................................................................................... 23
Configure for an Integrated Environment ...................................................................................................... 25
Register Solid Edge .DLL File ....................................................................................................................... 25
Installing Smart 3D Marine Mode Software .......................................................................................................... 26
Install Smart 3D Marine Mode Client Software .............................................................................................. 26
Smart 3D Tribon Interface Setup ................................................................................................................... 27
Install Service Packs ..................................................................................................................................... 27
Large Model Drawing Generation Configuration ........................................................................................... 29
Configure for an Integrated Environment ...................................................................................................... 29
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 ...................................................................................... 33
Install the Application on the Application Delivery Server.............................................................................. 34
Publish the Application on the Application Delivery Server ........................................................................... 34
Additional Citrix Implementation Topics ................................................................................................................. 35
Adding Application Path Statements to the System Path ..................................................................................... 35
Configuring Dual Monitors .................................................................................................................................... 36
Citrix Client Time Zones ....................................................................................................................................... 37
Disable the Citrix Virtual Memory Optimizer ......................................................................................................... 37
Index ........................................................................................................................................................................... 39

Citrix Marine Mode Guide

Contents

Citrix Marine Mode Guide

Preface
This document describes how to install, configure, and use Intergraph Smart
XenApp 6.5.

TM

3D on Citrix

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
TM

Intergraph Smart 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.
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.

Citrix Marine Mode Guide

Preface
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.

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.

Citrix Marine Mode Guide

Preface
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 Marine 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

TM

The following changes have been made to Citrix integration with Intergraph Smart 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 Marine 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 Marine Mode Guide

11

Smart 3D and Citrix

12

Citrix Marine 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 your 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
your 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 your 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
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.

Citrix Marine Mode Guide

13

Installation of SmartPlant License Manager

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 you 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.
Type 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 Marine 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.
As a firewall is used to prevent unauthorized port access, SmartPlant License Manager has
problems working properly with a firewall. Most firewall softwares allow an Administrator to open
ports to prevent the firewall from interfering with the software execution. SmartPlant License
Manager utilizes random ports, and there is not a good way to do this unless the firewall also
allows softwares to be added to a program list with permissions to open ports required by the
SmartPlant License Manager.
If the user exits 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 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 (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 Marine 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 Marine 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 Marine 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 Marine 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
TM
new version. For more information, see Application Maintenance in the Intergraph 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 Marine 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 Marine Mode Guide

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

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
Management Tools - Complete

Citrix Marine Mode Guide

21

Client/Workstation Setup

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.
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.

22

Citrix Marine Mode Guide

Client/Workstation Setup
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.

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 Intergraph
TM
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, see
TM
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, your 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
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.

Citrix Marine Mode Guide

23

Client/Workstation Setup

24

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.
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 Intergraph Smart
3D PDS Project Translators.

Citrix Marine Mode Guide

Client/Workstation Setup

Intergraph Smart 3D Tribon Interface Installation - Installs the Intergraph 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 Intergraph Smart 3D Tribon Interface Setup (on
page 27).
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 programs. 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.

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 Marine Mode Guide

25

Client/Workstation Setup

Installing Smart 3D Marine Mode Software

Smart 3D marine mode is a complementary, full-suite solution that provides all the capabilities
required to design and build a ship. The software provides a full range of flexible ship design,
production, and life cycle management capabilities within a single integrated environment. The
Intergraph Smart 3D DVD includes the following:
Smart 3D plant mode application, reference data, and programming resources software.
Smart 3D marine mode application and reference data. The Smart 3D marine mode reference
data provides the ship-specific task environments, symbols, and database templates.
Before you install the Smart 3D marine mode software on a computer, you must first
verify that the required software - including all prerequisite software - is also installed. For detailed
information about installing the required software, see Software Loading Order.

Install Smart 3D Marine Mode Client Software

Approximately 780 MB of hard disk space is required to install the Smart 3D marine mode
software on a workstation computer. Prior to installing Smart 3D marine mode, select and size the
hard disk partitions of the computer accordingly.

Before installing the Smart 3D marine mode software, verify that the Smart 3D plant mode
software and the proper prerequisite software have been installed on the workstation
computer according to the instructions outlined in Install Smart 3D Client Software (on page
23).
If you have an older version of SmartMarine 3D installed on your computer, uninstall it before
loading the new software. For more information, see Remove Smart 3D Marine Mode
Software.
You must have administrator privileges on the computer to install the software.
TM
1. Insert the Intergraph Smart 3D Product CD.
The main screen appears.
If setup does not start automatically, double-click Setup.exe in the root folder of the CD.
2. Select Smart 3D Marine Installation.

3.
4.
5.
6.

If Smart 3D marine mode determines that Smart 3D plant mode software is not installed,
an error message is displayed. Click OK, and install the Smart 3D plant mode software.
Click Next.
On the User Information page, type information in the Full Name, Organization, and Serial
number boxes. The serial number sticker is located on the CD jewel case.
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; consequently, you must have
Acrobat Reader installed on the computer in order to view the license agreement. If the
software detects that Acrobat Reader is not installed, a message box appears. To install
TM
Acrobat Reader (from the Intergraph Smart 3D Product CD) and continue with the
installation, click Yes. If you click No on the message box, the setup process immediately
stops without installing Smart 3D.
7. Carefully read the license agreement. Close the PDF document, and click Yes on the
Software License Agreement page to accept the terms.

26

Citrix Marine Mode Guide

Client/Workstation Setup
8. On the Select Features page, select the features that you want installed.

9. Click Browse and select the folder location for the workstation software, and click OK.

10.
11.
12.
13.

You must install the Smart 3D marine mode software in the same folder as Smart
3D plant mode.
Click Next.
Click Next on the Ready to Install the Application page to begin installing Smart 3D marine
mode.
Click Finish to exit the installation sequence.
Restart the computer to complete the installation.

See Also
Installing Smart 3D Marine Mode Software (on page 26)

Smart 3D Tribon Interface Setup

Installing the Smart 3D Tribon Interface component allows you to import Tribon Initial Design M3
structural data into Smart 3D in marine mode for planning and outfitting purposes.
TM
Intergraph Smart 3D Tribon Interface (SEBY812AA) is a separately-licensed product. Please
contact Intergraph Support for licensing information.
Refer to Install Smart 3D Client Software (on page 23) for setup instructions.
TM
Prior to installing the Smart 3D Tribon Interface, you must also have the Intergraph Smart 3D
TM
PDS Project Translators (SEBY801AA) component installed. Intergraph Smart 3D PDS
Project Translators (SEBY801AA) is also a separately-licensed product. Please contact
Intergraph Support for licensing information.
If you have an older version of Smart 3D Tribon Interface installed on your computer,
uninstall it before loading the new version.

Install Service Packs

Service Packs contain fixes for known application issues. You should install only those service
packs that contain fixes that you need or if you are instructed to do so by Intergraph Support.
Service pack installations contain only those parts of the application that have changed, and
therefore, must be installed "on top" of a regular installation.

Citrix Marine Mode Guide

27

Client/Workstation Setup
You must have administrative privileges on the computer to install the service pack.
You can use the Run as Administrator option.
1. Exit all other applications running on your computer.
2. Double-click the service pack's setup.exe file.
3. If you are installing the service pack on the reference data server, select Reference Data
Service Pack X Installation.
-ORIf you are installing the service pack on a client workstation, select Service Pack X
Installation.
4. Click OK on the exit message.
5. Click Install.

6. If you want to create an uninstaller, click Yes. Otherwise, click No. If you choose not to create
an uninstaller, you must remove the entire application to uninstall the service pack changes.
7. Click OK to confirm the installation folder. This folder should be the same folder where you
installed the regular installation.

You will see WinZip Self-Extractor windows appear as the service pack installs.

28

Citrix Marine Mode Guide

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

Large Model Drawing Generation Configuration

When you are working with large models, especially in the Drawings and Reports task, we
recommend that you enable the 3GB option for 32-bit operating systems and have 4GB or more
RAM to improve drawing generation performance. While there is no hard and fast rule as to what
constitutes a large model, we recommend that you enable the 3GB option if you are going to
create drawings that contain more than 5,000 elements. That number can be lower if the drawing
elements are complex.
Windows 7 uses the BCDedit.exe (Boot Configuration Data Editor) utility to make 3GB of RAM
accessible for software on 32-bit Windows 7 computers. This utility is run from a command
window as an administrator. You do not need to run this utility for 64-bit versions of Windows 7.
1. Click Start > All Programs > Accessories.
2. Right-click on Command Prompt and select Run as Administrator.
3. Click Continue when prompted by the User Account Control.
4. Enable 3GB RAM mode by keying in:
bcdedit /set IncreaseUserVa 3072
Disable 3GB RAM mode by keying in:
bcdedit /deletevalue IncreaseUserVa
5. Restart your computer.

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.

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.

Citrix Marine Mode Guide

29

Client/Workstation Setup
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.

30

Citrix Marine 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 Marine Mode Guide

31

Instructions for Windows 2008 Server

32

Citrix Marine 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 33)

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.

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.

Citrix Marine Mode Guide

33

Deploying SmartPlant Enterprise on Citrix

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 installers 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. When you click Next, 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.

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.

34

Citrix Marine 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 (based 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 a software registers an application path, 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 Marine Mode Guide

35

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.

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.

36

Citrix Marine Mode Guide

Additional Citrix Implementation Topics

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

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.
Computer Management >Services and Applications > Services > Citrix Virtual Memory
Optimization > Disabled.

Citrix Marine Mode Guide

37

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.

38

Citrix Marine 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
31, 36
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 Service Packs 34
Install Smart 3D Client Software 29
Install Smart 3D Marine Mode Client
Software 32
Install the Application on the Application
Delivery Server 40
Installation of SmartPlant License Manager
19
Installing Microsoft SQL Server 2008 Client
26
Installing Smart 3D Marine Mode Software
32
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 32, 36
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
Smart 3D Tribon Interface Setup 34
SmartPlant License Manager and Citrix 22

W
What's New with Citrix Integration 15

L
Large Model Drawing Generation
Configuration 35
Loading Prerequisite Software on the Client
25

Citrix Marine Mode Guide

39