marine s3d citrix guide

8/10/2019 Marine S3d citrix guide

1/39

CitrixMarine Mode Guide

Version 2014 (10.0)

Monday, September 02, 2013

DSHIP-PE-200092E


2/39

2 Citrix Marine Mode Guide

Copyright

Copyright 2009-2013 IntergraphCorporation. All Rights Reserved. Intergraph is part of Hexagon.

Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; containsconfidential and proprietary information of Intergraph and/or third parties which is protected by copyright law, trade secret law, andinternational 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 Restric ted Rights Legend

Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies: This was developedat 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") andits successors, and is unpublished and all rights are reserved under the copyright laws of the United States. For units of the Departmentof Defense ("DoD"): This is "commercial computer software" as defined at DFARS 252.227-7014 and the rights of the Government areas specified at DFARS 227.7202-3.

Unpublished - rights reserved under the copyright laws of the United States.

Intergraph Corporation300 Intergraph WayHuntsville, 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, orbox.net, any documentation related to work processes, workflows, and best practices that is provided by Intergraph as guidance forusing 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 softwareproduct unless the Licensee has a valid signed license for this software product with Intergraph Corporation. If the Licensee has avalid signed license for this software product with Intergraph Corporation, the valid signed license shall take precedence andgovern the use of this software product and Documentation. Subject to the terms contained within the applicable licenseagreement, Intergraph Corporation gives Licensee permission to print a reasonable number of copies of the Documentation asdefined 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 OtherDocumentation for Licensees internal non-commercial use. Intergraph Corporation gives Licensee permission to print areasonable number of copies of Other Documentation for Licensees internal, non-commercial. The Other Documentation maynot be printed for resale or redistribution. This license contained in this subsection b) may be terminated at any time and for anyreason 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, IntergraphCorporation disclaims any and all express or implied warranties including, but not limited to the implied warranties of merchantabilityand fitness for a particular purpose and nothing stated in, or implied by, this document or its contents shall be considered or deemed amodification or amendment of such disclaimer. Intergraph believes the information in this publication is accurate as of its publicationdate.

The information and the software discussed in this document are subject to change without notice and are subject to applicabletechnical 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 l icense 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 FINALEVALUATION 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. Usersshould 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


3/39

Citrix Marine Mode Guide 3

OR PROFIT, LOSS OF DATA, OR CLAIMS OF THIRD PARTIES, EVEN IF INTERGRAPH CORPORATION HAS BEEN ADVISED OFTHE POSSIBILITY OF SUCH DAMAGES.

UNDER NO CIRCUMSTANCES SHALL INTERGRAPH CORPORATIONS LIABILITY EXCEED THE AMOUNT THAT INTERGRAPHCORPORATION HAS BEEN PAID BY LICENSEE UNDER THIS AGREEMENT AT THE TIME THE CLAIM IS MADE. EXCEPTWHERE PROHIBITED BY APPLICABLE LAW, NO CLAIM, REGARDLESS OF FORM, ARISING OUT OF OR IN CONNECTIONWITH THE SUBJECT MATTER OF THIS DOCUMENT MAY BE BROUGHT BY LICENSEE MORE THAN TWO (2) YEARS AFTERTHE 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, itssubsidiaries, or distributors (including any Documentation, Other Documentation or technical data related to these products) aresubject to the export control laws and regulations of the United States. Diversion contrary to U.S. law is prohibited. These SoftwareProducts, and the direct product thereof, must not be exported or re-exported, directly or indirectly (including via remote access) underthe 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 CommerceDenied 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 StateDebarred 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 sensitivenuclear 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 ExportCompliance 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 registeredtrademarks of Intergraph Corporation or its subsidiaries in the United States and other countries. Microsoft and Windows are registeredtrademarks of Microsoft Corporation. ACIS is a registered trademark of SPATIAL TECHNOLOGY, INC. Infragistics, Presentation LayerFramework, ActiveTreeView Ctrl, ProtoViewCtl, ActiveThreed Ctrl, ActiveListBar Ctrl, ActiveSplitter, ActiveToolbarsCtrl, ActiveToolbars Plus Ctrl, and ProtoView are trademarks of Infragistics, Inc. Incorporates portions of 2D DCM, 3D DCM, and HLMby Siemens Product Lifecycle Management Software III (GB) Ltd. All rights reserved. Gigasoft is a registered trademark, andProEssentials a trademark of Gigasoft, Inc. VideoSoft and VXFlexGrid are either registered trademarks or trademarks ofComponentOne LLC 1991-2013, All rights reserved. Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of OracleCorporation 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.


4/39



5/39


ContentsPreface ......................................................................................................................................................................... 7

Documentation Set ................................................................................................................................................. 7

Documentation Comments ................................................................................................................................... 10

What's New with Citrix Integration ........................................................................................................................... 10

Smart 3D and Cit rix ................................................................................................................................................... 11

Installation of SmartPlant License Manager ........................................................................................................... 13

Microsoft Windows Firewall and SmartPlant License Manager ............................................................................ 15SmartPlant License Manager and Citrix ............................................................................................................... 16

Client /Workstat ion Setup .......................................................................................................................................... 19

Loading Prerequisite Software on the Client ........................................................................................................ 19Install Microsoft .NET Framework (Database Server) ................................................................................... 19

Install Microsoft XML 6.0 ............................................................................................................................... 19Install Microsoft Office ................................................................................................................................... 20

Installing Microsoft SQL Server 2008 Client ......................................................................................................... 20Register SQL Server 2008 ............................................................................................................................ 22

Install Smart 3D Client Software ........................................................................................................................... 23Configure for an Integrated Environment ...................................................................................................... 25Register Solid Edge .DLL File ....................................................................................................................... 25

Installing Smart 3D Marine Mode Software .......................................................................................................... 26Install Smart 3D Marine Mode Client Software .............................................................................................. 26Smart 3D Tribon Interface Setup ................................................................................................................... 27Install Service Packs ..................................................................................................................................... 27Large Model Drawing Generation Configuration ........................................................................................... 29Configure 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 .......................................................................................................................... 33Set Up the Citrix XenApp 6.5 Server .................................................................................................................... 33Publish Applications on the Application Delivery Server ...................................................................................... 33

Install the Application on the Application Delivery Server .............................................................................. 34Publish the Application on the Application Delivery Server ........................................................................... 34

Addi tional Citr ix Implementation Topics ................................................................................................................. 35

Adding Application Path Statements to the System Path ..................................................................................... 35Configuring Dual Monitors .................................................................................................................................... 36Citrix Client Time Zones ....................................................................................................................................... 37

Disable the Citrix Virtual Memory Optimizer ......................................................................................................... 37

Index ........................................................................................................................................................................... 39


6/39

Contents



7/39


This document describes how to install, configure, and use Intergraph SmartTM

3D on CitrixXenApp 6.5.

Documentation SetIntergraph Smart

TM3D documentation is available as Adobe PDF files. The content is the same as

the online Help. To access these PDF documents, click Help > Printable Guidesin the software.

The documentation set is divided into four categories:

Administrative guides contain information about installing, configuring, customizing, andtroubleshooting.

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

ISOGEN guides.

Administrat ive Guides

Intergraph SmartTM

3D Installation Guide- Provides instructions on installing and configuring thesoftware.

Project Management User's Guide - Provides instructions for setting up the databases, creatingpermission groups, backing up and restoring project data, assigning access permissions to themodel, defining and managing locations for Global Workshare, and version upgrade.

Global Workshare Guide- Provides instructions for setting up the software and the databases towork in a workshare environment.

Interference Checking Guide- Provides information on installing, configuring, and using theinterference detection service.

Integration Reference Guide- Provides information about installing, configuring, and using Smart3D in an integrated environment.

Interpreting Human Piping Specifications- Provides information about how to interpret humanpiping 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 arealso included.

Point Cloud Reference- Provides information for referencing point cloud files provided by pointcloud vendors in Smart 3D.

Troubleshooting Reference Guide - Provides information on how to resolve errors that you mightencounter in the software by documenting troubleshooting tips, error messages, and To Do Listmessages.

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 importingthat data into Smart 3D, and converting PDS reference data to Smart 3D reference data.

Intergraph SmartTM

3D Programmer's Guide- Provides information about custom commands,naming rules, and symbol programming. If you install the Programming Resources, this documentis delivered to the [Product Folder]\Programming\Help folder.

Preface


8/39

Preface


User's Guides

Catalog User's Guide- Provides information about viewing, editing, and creating reference dataand 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 ascompartments 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 exportingmodel 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 cablewaysupports in the model.

Hole Management User's Guide- Provides instructions for placing, reviewing, and approvingholes 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 managingorthographic drawings.

Piping Isometric Drawings User's Guide- Provides information about creating and managingpiping isometric drawings.

Piping User's Guide- Provides instructions for routing pipe and placing valves, taps, and pipejoints.

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, loadcombinations, and the importing and exporting of analytical data.

Structural Detailing User's Guide- Provides instructions for creating, detailing, and maintainingthe structural members of a model.

Structural Manufacturing User's Guide- Provides instructions for creating and maintainingmanufacturing 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 andselecting the available specifications for each system type.

Reference Data Guides

2D Symbols User's Guide- Provides command reference information and procedural instructionsfor creating 2D symbols used to represent collars, clips, profiles, brackets, and other items.


9/39

Preface


2D Symbols Reference Data Guide- Provides information about the two-dimensional symbolsused in all tasks.

Compartmentation Reference Data Guide- Provides information about compartmentationreference data.

Drawings and Reports Reference Data Guide- Provides information about reports reference data.

Electrical Reference Data Guide- Provides information about electrical cable, cableway, cabletray, and conduit reference data.

Electrical 3D Symbols Reference- Provides information about the cable tray and conduit 3Dsymbols that are available.

Equipment and Furnishings Reference Data Guide- Provides information about equipmentreference data.

Equipment 3D Symbols Reference- Provides information about the equipment, equipmentcomponent, design shapes, and design aides 3D symbols that are available.

Hangers and Supports Reference Data Guide- Provides information about hangers and supportsreference data.

Hangers and Supports 3D Symbols Reference- Provides information about the hanger andsupport 3D symbols that are available.

Hangers and Supports SmartPart Symbols Reference- Provides information about the hangerand 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 areavailable.

Reference Data Guide- Provides instructions about the Bulkload utility, codelists, and thereference data common to several disciplines.

Piping Reference Data Guide- Provides information about piping reference data including pipingspecifications, piping specification rules, piping parts, and piping symbols.

Piping 3D Symbols Reference- Provides information about the piping 3D symbols that areavailable.

Space Management Reference Data Guide- Provides information about space managementreference data.

Structure Reference Data Guide- Provides information about structural reference data.

Structure 3D Symbols Reference- Provides information about the stair, ladder, footings, andequipment foundation 3D symbols that are available.

Structural Reference Data Overview- Provides an overview of the marine mode structuralreference data library.

ISOGEN Guides

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


10/39

Preface


Documentation CommentsWe welcome comments or suggestions about this documentation. You can send us an email at:[email protected].

Documentation updates for supported software versions are available from eCustomer

https://crmweb.intergraph.com.

What's New with Citrix IntegrationThe following changes have been made to Citrix integration with Intergraph Smart

TM3D.

Version 2014 (10.0)

Added instructions for Windows 2008 Server. For more information, see Instructions forWindows 2008 Server(on page31). (P3 CP:225278)

Added instructions for installing Microsoft .NET Framework (Database Server). For moreinformation, see Install Microsoft .NET Framework (Database Server)(on page19). (P3CP:225278)
https://crmweb.intergraph.com/https://crmweb.intergraph.com/https://crmweb.intergraph.com/


11/39


S E C T I O N 1

Intergraph SmartTM

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

Smart 3D and Citrix


12/39

Smart 3D and Citrix



13/39


S E C T I O N 2

Before beginning the product installation, refer to the delivered SmartPlant License Managerreadme file for the latest product installation updates. The readme file is delivered in the top levelproduct folder of the product media. Be sure you have the latest version of the SmartPlant LicenseManager software before beginning the installation. If you do not have the latest version of thesoftware, 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 Manager2012 (v12). Any existing license key will be invalidated after the upgrade to SmartPlant LicenseManager 2012 (v12). You will also need to generate a new computer ID and request a new key. Ifyou upgrade the SmartPlant License Manager 2010 (v11) license computer to a SmartPlantLicense Manager 2012 (v12) client by mistake, you will have to un-install the SmartPlant LicenseManager 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, becauselicense key installation and license seat usage authentication depends on the informationgathered from the physical hardware. Any automated changes that cause the hardwareinformation not to match with the information used to generate the license key will result in a failureof the authentication process.

Virtual (including VMware), shadowed, mirrored, dynamic, or distributed hardwareconfigurations 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 LicenseManager Server licensing computer should be installed on a separate dedicated hardwareconfiguration system. The SmartPlant License Manager licensing computer should be situated onyour network where it can be accessed by all systems that are running application software thatrelies on the SmartPlant License Manager licensing computer for license management.

Multiple SmartPlant License Manager licensing computers can be used in your network as long aseach system is a unique hardware system/installation. If SmartPlant License Manager licensingcomputers are cloned after the license key has been installed, then the license management willfail on the cloned system. Each SmartPlant License Manager licensing computer requires its ownunique license key.

RAID (redundant array of independent disks) and SAN (storage area networks) are notsupported on a SmartPlant License Manager license computer.

The license computer must have the same version (or later) of SmartPlant License Managerinstalled as any client computers. In other words, you cannot use a newer version on a clientcomputer to retrieve a license from an older version of SmartPlant License Manager on thelicensing 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.

Installation of SmartPlant License

Manager
http://ppmapps.intergraph.com/elicensehttp://ppmapps.intergraph.com/elicensehttp://ppmapps.intergraph.com/elicensehttp://ppmapps.intergraph.com/elicense


14/39


15/39

Installation of SmartPlant License Manager


Microsoft Windows Firewall and SmartPlant LicenseManager

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 port807 is required to be open and is utilized by the SmartPlant License Manager license machine tolisten for requests from the workstation(s) for a license seat. If a request is made, a random TCPport is utilized to pass the seat from license machine to client.

As a firewall is used to prevent unauthorized port access, SmartPlant License Manager hasproblems working properly with a firewall. Most firewall softwares allow an Administrator to openports to prevent the firewall from interfering with the software execution. SmartPlant LicenseManager utilizes random ports, and there is not a good way to do this unless the firewall alsoallows softwares to be added to a program list with permissions to open ports required by theSmartPlant License Manager.

If the user exits the application properly, the license used by the workstation is released back tothe pool of licenses available. Sometimes, when an application process is exited abnormally, thelicense seat is not returned to the license manager. This is where the SmartPlant LicenseManager license machine can help. A scavenge routine can be setup to run that will scavenge thenetwork for seats that are reserved. If one is found, the seat can be returned to the pool if it is nolonger in use. The firewall prevents the license machine from retrieving the seat and returns atimed out error message.

In order to run commands using the Command Prompt window, pdlice.exe needs to beadded to the Exception List for the Windows Firewall on both the license machine and the clientmachine (if it is turned on). This includes all Windows operating system (for example, MicrosoftWindows 7, Windows Server 2008 R2, Windows Server 2003, Windows XP, and so forth). Thefollowing steps provide an example of how to add the appropriate SmartPlant License Manager tothe Exception List for Microsoft Windows 7 (allowing for proper scavenging and access to thelicense machine).

1. Select Start > Control Panel > Windows Firewallto display the Windows Firewall options.

2. Click to selectAl low a program or feature through Windows Firewall .

3. Click Change settings.

4. ClickAllow another program .

5. Click Browse on theAdd 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. ClickAdd on theAdd a Program dialog box. SmartPlant License Manager now displays intheAl lowed programs and features list.

9. Click OK to dismiss the Windows Firewalloptions.

[Connecting Socket] Connection Time Outis the error message you receive ifpdlice.exe is not defined in the Windows Firewall exception list.


16/39



SmartPlant License Manager and CitrixBefore you install any SmartPlant Enterprise software on a Citrix server, you must install andconfigure the Citrix software and the corresponding prerequisites on the server. Please refer toyour 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 isrequired for the product to run on a desktop client system. Make sure that any patches orprerequisite software installations are matched to the operating system. For example, a 64-bitoperating system may require that some patches or products are also 64-bit. All patches orproducts should be in accordance with administrative guidance. For more information aboutsoftware prerequisites for SmartPlant Enterprise products, see the documentation delivered withthe product.

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

The SmartPlant License Manager license machine does not support a NAT configuration on aCitrix 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 SPLMFailed: Server/Client Timers Mismatch by 6+ Hours - can display. Tocorrect the error, adjust the Citrix server's Time Zone Redirection configuration to prevent itfrom using the client's local time zone for the Citrix session. For more information, refer to theCitrix'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 LicenseManager, you cannot use Test Seat Reservationand Test Seat Release(commands in theSmartPlant License Manager product) to test the licensing machines. Those test options areused to test for the licensing machine configured in the SmartPlant License Manager's registrykey (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 inHKLM_Current_User).


17/39



Additional information about certified Citrix versions is available on the SmartPlant EnterpriseProduct Compatibility Matrix on the Intergraph Process, Power & Marine eCustomer Web site. Toview this matrix, browse to the following Web address, and type your eCustomer user name andpassword: https://crmweb.intergraph.com . Click Download Software Updates > Produc ts ,

and then click the PPM Compatibili ty Matriceslink 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 recommendedfor 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 toAppendix E: Microsoft Windows Firewall and SmartPlant License Manager.

Installing and Configuring the Product

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


18/39



SmartPlant License Manager for use with Citrix. Configuring and installing SmartPlant LicenseManager 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 theSmartPlant License Manager application in accordance with standard Citrix practices. Use theprovided Start > Intergraph SmartPlant License Managermenu for SmartPlant LicenseManager 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.


19/39


S E C T I O N 3

The Smart 3D client software is used for general modeling, as well as for performing a variety ofadministrative activities, including managing permissions, backing up and restoring data, creatingplants, and monitoring database interference detection. Additionally, the software providesfeatures that extend the capabilities of the software to include importing model data andintegrating Smart 3D with SmartPlant P&ID.

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

TM3D

Installation Guide.

Loading Prerequisite Software on the ClientThe following prerequisite software is required in order to install and use the software on a clientcomputer:

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

1. Log on to the computer as an administrator.

2. Start Server Manager.

3. Select Featuresin the console tree.

4. ClickAdd Featuresin the Features Summaryarea.

TheAdd Features Wizard displays.

5. Select .NET Framework 3.5.1 Featuresfrom the list of available features.

6. Click Install, and follow the prompts.

Install Microsoft XML 6.0To install Microsoft XML 6.0, open your web browser and go to the MSXML Developer CenterWeb Site(http://msdn.microsoft.com/xml/). Follow the guidelines to click the appropriate link fordownloading MSXML 6.0 on the workstation computer.

1. When downloading is complete, double-click the setup file.

2. On the Welcomepage, click Next.

3. On the End-User L icense Agreementpage, click I accept the terms in the LicenseAgreement and click Next.

4. On the Customer Informationpage, type your name and organization and click Next.

5. On the Choose Setup Typepage, click Install Now.

6. Click Finishon the Setup Completepage.

Client/Workstation Setup
http://msdn.microsoft.com/xml/http://msdn.microsoft.com/xml/http://msdn.microsoft.com/xml/http://msdn.microsoft.com/xml/


20/39



See AlsoSetting Up the Client(see "Client/Workstation Setup"on page19)

Install Microsoft OfficeSeveral 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 andbulk load them into the Catalog database. The current release of the software supports Office2010 (32-bit).

The system language specified for Microsoft Office must be the same as the system languagespecified 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 ProgrammingSupport 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 formultiple users to run reports.

See AlsoLoading Prerequisite Software on the Client(on page19)

Install ing Microsoft SQL Server 2008 ClientBecause system configurations and individual company standards vary, use this section as achecklist instead of step-by-step instructions for Microsoft SQL Server 2008 SP3. Please contactIntergraph 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 notneed 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.

Microsoft SQL Server 2008 SP3 requires XML 6.0 and will automatically install it as part of theSQL Server 2008 Prerequisite installation.

There are internationalization considerations concerning the SQL Server collation settings youspecify that relate to reference data, using SmartPlant Enterprise integrated systems, GlobalWorkshare Configuration, multiple locales, backup/restore, reports, and upgrading to futurereleases. 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 beinstalled before installing XenApp 6.5.


21/39



1. Insert your SQL Server DVD and start the setup.

2. From the Planning page, select System Configuration Checkerto check for pre-requisiteapplications as well as identify potential installation problems.

You may be asked to restart your computer if any pre-requisite applications wereinstalled.

3. Click Installationand select the New SQL Server stand-alone installation o r add featuresto an existing installation option.

4. As you go through the installation process, make sure you install the Setup Support Filesand 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


22/39



6. When you get toInstallation Rules, make sure all operations have passed.

7. From Ready to Install, click Install.

8. When the installation has been completed, review the summary log file for any problems.

9. Before you use the software, you must register it. See Register SQL Server 2008(on page22).

10. Install any required service packs or upgrades for SQL Server 2008. See Install any RequiredSQL Server 2008 Upgrades.

Register SQL Server 2008You 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 Serversappear in the left tree view.

3. In the tree view, right-click Database Engine, and select New > Server Registrationin theshortcut menu.

The New Server Registrationdialog box appears.


23/39



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, registerthe server with a fully qualified domain. For example, a server on the INGRPPO domainnamed 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 Guidesin the software.

6. Exit Management Studio.

Install Smart 3D Client SoftwarePrior to installing Smart 3D on a workstation computer, verify that the workstation computer meetsthe required hardware and software requirements and that all prerequisite software has beeninstalled. For more information, see Smart 3D Workstation Recommendations in the IntergraphSmart

TM3D Installation Guide. For more information about the prerequisite software, see Loading

Prerequisite Software on the Client(on page19).

Remove the older version of Smart 3D before loading the new version. For more information, seeRemove Smart 3D Software in the Intergraph Smart

TM3D Installation Guide.

You must have administrator privileges on the computer to install the software. We recommendusing the Run as Administratoroption.

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 concurrentlicensing for both the core Smart 3D product and for each module. This licensing software isdelivered on its own DVD that comes with your Smart 3D DVD. For more information about usingand configuring concurrent licensing, see the SmartPlant License Manager Installation and User'sGuide (SPLMInstall_UserGuide.pdf).

During setup, the %temp% value is defined as the user %temp% of the person whoruns the setup. In Windows, your C:\Documents and Settings\username\Local Settings\Temp isprotected from other Windows users. Consequently, you must set the system environmentvariable 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-clickSetup.exein the root folder of the DVD and select Run as administrator.

2. ClickAddi tional Software, and the select the optional software that you need to install, if any:

Install SmartPlant Schema ComponentInstall PDS Export ToolsInstall PDS Data Access

3. Click Backif needed.

4. Click Full Installationor Evaluation Installationbased on your needs.

5. Read the license agreement. Click to agree to the Software License Agreement, and thenclick 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 themodeling tasks such as Common, Piping, Equipment, Structure, and so forth.


24/39



Project Management- Installs the Project Managementclient used for creatingmodels, managing access control, and upgrading databases. Select this option for anadministrator's computer. You must also install the Server Connectivityoption(below) and the Microsoft SQL Server client tools. The Microsoft SQL Server clienttools are not required on computers where Project Managementis not installed or ifyou are using Oracle as your database provider.

Bulkload Reference Data- Installs sample Microsoft Excel reference dataworkbooks 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. Youmust also install the Server Connectivi tyoption if you select this option.

Piping Specification Remote Access Server- Installs the necessary software forcorrelating piping specification data between Smart 3D and SmartPlant P&ID. Thisoption sets up the computer as a remote access server by registering theSP3DPipingSpecRemoteAccessServer COM+ component. For more informationabout the P&ID integration capabilities of the software, see Integrating withSmartPlant P&ID in the Intergraph Smart

TM3D Installation Guide.

Database Interference Detection Service- Installs the software required fordatabase interference detection. You must configure this service through Windows

Services. Requires the Project Managementand the Server Connectivit ycomponents. For more information, see Interference Checking Setup.

Server Connectivit y- Installs required database connectivity components forProject Management, the Bulkload Utility, Piping Specification Remote AccessServer, and the Database Interference Detection Service.

64-bit Services- Installs the 64-bit version of the Interference Checking andDrawings Batch Services components.

64-bit Services cannot be uninstalled individually. You must remove allof 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 f ind the minimuminstalled cost route for the pipe. To do this a number of candidate routes are generated foreach routing requirement and the one with the lowest "Evaluation Cost" is returned as theroute solution.

Name Generator Installation - Installs the 32-bit version of the Name Generator. Installthis one if you are installing the Name Generator on a computer where the Oracle 32-bitclient 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 serveroperating system, you are using Microsoft SQL Server, or you are installing on an Oracledatabase server.

For more information about which version of the Name Generator you needand about the Name Generator in general, see Name Generator Service Setup.

Reference Data Installation- Installs the reference data needed to run Smart 3D. Youshould pick one server on which to install the reference data. Do not install reference dataon each client or administrator computer. For more information, see Reference DataSetup.

Smart 3D PDS Project Translators Installation - Installs the Smart 3D PDS ProjectTranslators(licensed-separately) component that further extends the PDS integrationcapabilities by allowing you to export Piping, HVAC, Electrical, Equipment, and Structuremodel data from PDS into Smart 3D. For more information, see Install Intergraph Smart3D PDS Project Translators.


25/39



Intergraph Smart 3D Tribon Interface Installation - Installs the Intergraph Smart3D Tribon Interface(licensed-separately) component that allows you to import TribonInitial Design M3 structural data into Smart 3D in marine mode for planning and outfittingpurposes. For more information, see Intergraph Smart 3D Tribon Interface Setup(onpage27).

Programming Resources Installation- Installs the Programming Resourcescomponent which provides developers with the tools necessary to customize the softwareby creating custom commands or custom programs. For more information, seeProgramming Resources Setup.

Serial numbers are used for product identification only. A license key is requiredto run the software. For more information about installing and using SmartPlant LicenseManager, 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 EnvironmentConfiguring 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 rapidcommunication among all Smart 3D project participants. Critical information is stored only once ina data-neutral warehouse, eliminating duplication and ensuring that timely, accurate data isalways 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 workstationcomputers, as necessary. For more information about installing Smart 3D components, seethe Integration Setup Guide, available in the SmartPlant Enterprise documentation set.

In order to take full advantage of the Smart 3D integration functionality, you mustinstall the SmartPlant Client and Schema Component on a Smart 3D workstation computer on

which the Project Management, Server Connectivity, and Piping Specification RemoteAccess Serveroptions are installed.

2. Use the Project Management task to register your Smart 3D model. For more informationabout registering models, see the Project Management User's Guide, available from Help >Printable Guides.

Register Solid Edge .DLL FileWhile not a prerequisite, Solid Edge can be used with Smart 3D. For optimum performance, installSolid Edge prior to running the Smart 3D software setup. In the event that Solid Edge is installedafter Smart 3D, you will need to manually register the Pvdt80.ocxfile.

Additionally, if you uninstall or reinstall either Smart 3D or Solid Edge from the workstationcomputer, 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 Startand select Explore.

2. Browse to [INSTALLDIR]\Smart3D\Core\Register and double-click RegisterPvtd80.vbs toregister the Pvdt80.ocx file on your computer.


26/39



Install ing Smart 3D Marine Mode SoftwareSmart 3D marine mode is a complementary, full-suite solution that provides all the capabilitiesrequired 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. TheIntergraph Smart 3DDVD 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 referencedata provides the ship-specific task environments, symbols, and database templates.

Before you install the Smart 3D marine mode software on a computer, you must firstverify that the required software - including all prerequisite software - is also installed. For detailedinformation about installing the required software, see Software Loading Order.

Install Smart 3D Marine Mode Client SoftwareApproximately 780 MB of hard disk space is required to install the Smart 3D marine modesoftware 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 modesoftware and the proper prerequisite software have been installed on the workstationcomputer according to the instructions outlined in Install Smart 3D Client Software(on page23).

If you have an older version of SmartMarine 3D installed on your computer, uninstall it beforeloading the new software. For more information, see Remove Smart 3D Marine ModeSoftware.

You must have administrator privileges on the computer to install the software.

1. Insert the Intergraph SmartTM

3D ProductCD.

The main screen appears.

If setup does not start automatically, double-click Setup.exein the root folder of the CD.

2. Select Smart 3D Marine Installation.

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.

3. Click Next.

4. On the User Informationpage, type information in the Full Name, Organization, and Serialnumberboxes. The serial number sticker is located on the CD jewel case.

5. Click Next.

6. On the Software License Agreementpage, select your country from the list, and clickDisplayto view the license agreement.

The license agreement is delivered as a PDF file; consequently, you must haveAcrobat Reader installed on the computer in order to view the license agreement. If thesoftware detects that Acrobat Reader is not installed, a message box appears. To install

Acrobat Reader (from the Intergraph SmartTM

3D Produc t CD) and continue with theinstallation, click Yes. If you click Noon the message box, the setup process immediatelystops without installing Smart 3D.

7. Carefully read the license agreement. Close the PDF document, and click Yeson theSoftware License Agreementpage to accept the terms.


27/39



8. On the Select Featurespage, select the features that you want installed.

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

You must install the Smart 3D marine mode software in the same folder as Smart3D plant mode.

10. Click Next.

11. Click Nexton the Ready to Install the Appli cation page to begin installing Smart 3D marinemode.

12. Click Finishto exit the installation sequence.

13. Restart the computer to complete the installation.

See AlsoInstalling Smart 3D Marine Mode Software(on page26)

Smart 3D Tribon Interface SetupInstalling the Smart 3D Tribon Interface component allows you to import Tribon Initial Design M3structural data into Smart 3D in marine mode for planning and outfitting purposes.

Intergraph SmartTM

3D Tribon Interface (SEBY812AA) is a separately-licensed product. Pleasecontact Intergraph Support for licensing information.

Refer to Install Smart 3D Client Software(on page23)for setup instructions.

Prior to installing the Smart 3D Tribon Interface, you must also have the Intergraph SmartTM

3DPDS Project Translators(SEBY801AA) component installed. Intergraph Smart

TM3D PDS

Project Translators(SEBY801AA) is also a separately-licensed product. Please contactIntergraph 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 PacksService Packs contain fixes for known application issues. You should install only those servicepacks 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, andtherefore, must be installed "on top" of a regular installation.


28/39



You must have administrative privileges on the computer to install the service pack.You can use the Run as Administratoroption.

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

If you are installing the service pack on a client workstation, select Service Pack XInstallation.

4. Click OKon the exit message.

5. Click Install.

6. If you want to create an uninstaller, click Yes. Otherwise, click No. If you choose not to createan uninstaller, you must remove the entire application to uninstall the service pack changes.

7. Click OKto confirm the installation folder. This folder should be the same folder where youinstalled the regular installation.

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


29/39



See AlsoLoading Prerequisite Software on the Client(on page19)

Large Model Drawing Generation ConfigurationWhen 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 moreRAM to improve drawing generation performance. While there is no hard and fast rule as to whatconstitutes a large model, we recommend that you enable the 3GB option if you are going tocreate drawings that contain more than 5,000 elements. That number can be lower if the drawingelements are complex.

Windows 7 uses the BCDedit.exe (Boot Configuration Data Editor) utility to make 3GB of RAMaccessible for software on 32-bit Windows 7 computers. This utility is run from a commandwindow 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 Promptand select Run as Administrator.

3. Click Continuewhen prompted by the User Account Control.

4. Enable 3GB RAM mode by keying in:

bcdedi t / set I ncr easeUserVa 3072

Disable 3GB RAM mode by keying in:

bcdedi t / del eteval ue I ncr easeUserVa

5. Restart your computer.

Configure for an Integrated EnvironmentConfiguring 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 rapidcommunication among all Smart 3D project participants. Critical information is stored only once ina data-neutral warehouse, eliminating duplication and ensuring that timely, accurate data isalways 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, seethe Integration Setup Guide, available in the SmartPlant Enterprise documentation set.

In order to take full advantage of the Smart 3D integration functionality, you mustinstall the SmartPlant Client and Schema Component on a Smart 3D workstation computer onwhich the Project Management, Server Connectivity, and Piping Specification RemoteAccess Serveroptions are installed.

2. Use the Project Management task to register your Smart 3D model. For more informationabout registering models, see the Project Management User's Guide, available from Help >Printable Guides.

Register Solid Edge .DLL FileWhile not a prerequisite, Solid Edge can be used with Smart 3D. For optimum performance, installSolid Edge prior to running the Smart 3D software setup. In the event that Solid Edge is installedafter Smart 3D, you will need to manually register the Pvdt80.ocxfile.

Additionally, if you uninstall or reinstall either Smart 3D or Solid Edge from the workstationcomputer, use the steps outlined in the following procedure to manually register the Pvdt80.ocxfile.


30/39



You must have administrator privileges for the workstation computer on which youwant to register the file.

1. Open Windows Explorer. On the Windows task bar, right-click on Startand select Explore.

2. Browse to [INSTALLDIR]\Smart3D\Core\Register and double-click RegisterPvtd80.vbs toregister the Pvdt80.ocx file on your computer.


31/39


S E C T I O N 4

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

TM3DInstallation Guide.

Instructions for Windows 2008 Server


32/39

Instructions for Windows 2008 Server



33/39


S E C T I O N 5

To deploy SmartPlant Enterprise software on Citrix, the following high-level procedure must beperformed:

1. Set Up the Citrix License Server(on page33)

2. Set Up the Citrix XenApp 6.5 Server(on page33)

3. Publish Applications on the Application Delivery Server(on page33)

Set Up the Citrix License ServerA 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 theapplication 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 TerminalServices. Refer to the Citrix product documentation for detailed requirements, includingrequired versions of each component.

2. Run the Citrix License Server installation wizard.

Set Up the Citrix XenApp 6.5 ServerThe Citrix XenApp server must be installed and configured after the License Server has been setup.

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 detailedrequirements, 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 alsoinstalls the set of additional components selected at the beginning of the wizard, to include .NET3.5 Service Pack 1.

Publish Applications on the Application DeliveryServer

When installing applications on the application delivery server, you must perform the followinghigh-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.

Deploying SmartPlant Enterprise on

Citrix


34/39

Deploying SmartPlant Enterprise on Citrix


Install the Appl ication on the Appl ication Delivery Server

In a Citrix or Terminal Server environment, the operating system has two user modes. Thenormal 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-usersystem are instead made to a shadow key for each user and files that would be installed to ausers 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 anapplication 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 currentlyin use: change user /query command.

If you are going to install Smart 3D silently with a script under a Terminal Services Server inApplication Server mode, we recommend that you update the script to include a Change Usermode command to set the user mode to Install mode first, and then back to Execute modeafter the Smart 3D installation command. This ensures that changes written to registry keyHKEY_CURRENT_USER are properly redirected to their correspondingHKEY_LOCAL_MACHINE registry after each user logs in into the system. These steps arealso 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 toinstallation mode is done automatically. If this occurs, anAfter Ins tal lat ionwindow isdisplayed, with the instruction to click Next. When you click Next, the mode is set back toExecute mode, so it should not be done until the installation has finished.

1. In a command prompt window, type change user / i nst al l and press Enter.

You can confirm the current setting of the user mode by using the /queryswitch(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

/ execut eand press Enter.

Publish the Application on the Application Delivery Server1. Launch the Citrix AppCenter.

If this is the first time Citrix AppCenter has been launched on this server, a wizard willbe 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 OtherTasks > Publish application on the server.

4. Follow the prompts of the Publish Applicationwizard.


35/39


S E C T I O N 6

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

Adding Application Path Statements to the SystemPath

Windows stores system path statements for individual executable files under the following registrypath (based on the platform):

32-bit O/S: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppPaths\App_name.exe

64-bit O/S: HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\AppPaths\App_name.exe

When a software registers an application path, Windows adds the path statement to the searchpath whenever the application is run. This path information becomes part of the System SearchPath search order.

When applications are launched through Terminal Services (or Citrix), these path statements arenot automatically added. If an application requires this path, then the path information from theappropriate 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 referenceif there is an issue. Making a mistake during the modification of the system path variable canrender the computer unusable. It is essential to know the path contents prior to the modification tobring 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\AppPaths\App_name.exe

64-bit O/S: HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\AppPaths\App_name.exe

Additional Citrix Implementation Topics


36/39



2. Display the System Propertieswindow via the Control Panel.

3. Click theAdvanced tab.

4. Click Environment Variables.

5. In the System variableslist, select Path and click Edit.

6. Paste the value data from the Registry to the end of the Path string.

7. Click OK to dismiss all windows.

Configuring Dual MonitorsAfter logging into the Citrix portal via the Citrix Web Client, perform the following procedure.

1. Select the Preferencesmenu on the title bar.


37/39



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

Citr ix Client Time ZonesPlease see the article How to Configure Time Zone Redirection in XenApp 6.x Using the WindowsGroup 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 userregistry hive.

Disable the Citrix Virtual Memory OptimizerA service named Virtual Memory Optimization (VMO) can inadvertently corrupt the .NET imageson the computer. When the application that relies on the image attempts to start, it cannot. Itterminates quickly with .NET errors reported to the event logs. The problem is transient becausethe when the .NET optimizer service runs and the native images are processed and theapplication works again. The application will work until the VMO kicks in again causing imagecorruption.

To solve this problem, the Citrix Virtual Memory Optimizer (VMO) service needs to be set todisabled. This is done as a FARM-WIDE policy in the Citrix AppCenter the .Net optimizer shouldbe 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 MemoryOptimization>Disabled.


38/39



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.exeupdate" (Ignore any embedded errors many are expected. The process will take a fewminutes).

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 .NET2.0 NGEN is the unified definition for all of these versions of .NET there is currently no needto run NGEN for 3.0/3.5/1.1 just for 2.0. If 2.0 does not exist on the computer, then the3.0/3.5 NGEN(s) would work.


39/39

AAdding Application Path Statements to the

System Path 43Additional Citrix Implementation Topics 43

C

Citrix Client Time Zones 46Client/Workstation Setup 25Configure for an Integrated Environment

31, 36Configuring Dual Monitors 45

DDeploying SmartPlant Enterprise on Citrix

39Disable the Citrix Virtual Memory Optimizer

46Documentation Comments 13Documentation Set 9

IInstall Microsoft .NET Framework (Database

Server) 25Install Microsoft Office 26Install Microsoft XML 6.0 26

Install Service Packs 34Install Smart 3D Client Software 29Install Smart 3D Marine Mode Client

Software 32Install the Application on the Application

Delivery Server 40Installation of SmartPlant License Manager

19Installing Microsoft SQL Server 2008 Client

26Installing Smart 3D Marine Mode Software

32Instructions for Windows 2008 Server 37

LLarge Model Drawing Generation

Configuration 35Loading Prerequisite Software on the Client

25

MMicrosoft Windows Firewall and SmartPlant

License Manager 21

P

Preface 7Publish Applications on the Application

Delivery Server 40Publish the Application on the Application

Delivery Server 41

R

Register Solid Edge .DLL File 32, 36Register SQL Server 2008 28

SSet Up the Citrix License Server 39Set Up the Citrix XenApp 6.5 Server 39Smart 3D and Citrix 17Smart 3D Tribon Interface Setup 34SmartPlant License Manager and Citrix 22

W

What's New with Citrix Integration 15

Index