You are on page 1of 44

TANK

Installation Guide

Version 2014 (6.0)

December 2013
DICAS-PE-200132C

Copyright
Copyright 1994 - 2013 Intergraph CAS, Inc. 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.
Contains RealDWG by Autodesk, Inc. Copyright 1998-2013 Autodesk, Inc. All rights reserved.

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.

TANK Installation Guide

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 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, http://www.treas.gov/offices/enforcement/ofac/, and the U.S.
Department of State Debarred List, http://www.pmddtc.state.gov/compliance/debar.html.

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, Intergraph Smart, PDS, SmartPlant, SmartMarine, FrameWorks, I-Sketch, IntelliShip, ISOGEN,
SmartSketch, SPOOLGEN, SupportManager, and SupportModeler are trademarks or registered trademarks of Intergraph
Corporation or its subsidiaries in the United States and other countries. Microsoft and Windows are registered trademarks of
Microsoft Corporation. MicroStation is a registered trademark of Bentley Systems, Inc. Other brands and product names are
trademarks of their respective owners.

TANK Installation Guide

TANK Installation Guide

Contents
TANK Installation Guide ............................................................................................................................. 7
What's New in TANK 2014...................................................................................................................... 9
Introduction ........................................................................................................................................... 10
Additional Intergraph CAS Software ..................................................................................................... 11
Licensing ............................................................................................................................................... 13
ESL Installation ............................................................................................................................... 14
SmartPlant License Manager Installation ....................................................................................... 17
Using the SmartPlant License Checkout Utility .................................................................................... 23
Install SmartPlant License Checkout Utility .................................................................................... 23
License Utility Checkout Dialog Box ............................................................................................... 24
Check Out a License for TANK ...................................................................................................... 24
Install TANK .......................................................................................................................................... 27
Before You Begin Installing the Product ......................................................................................... 28
Install TANK from the Media .......................................................................................................... 29
Install TANK on a Network ............................................................................................................. 29
Install TANK in Silent Mode ............................................................................................................ 32
Verify the Installed TANK Program Structure ................................................................................. 34
Troubleshoot Installation ....................................................................................................................... 35
Why do I get an error message saying TANK cannot locate the configuration file
when I try to run TANK? ................................................................................................................. 35
Why does the TANK Configuration Editor not open? Why does the Configuration
Editor not save and close? ............................................................................................................. 35
Update TANK Software ......................................................................................................................... 37
How do I find out about software updates? .................................................................................... 37
How do I download a software update? ......................................................................................... 37
Can software updates be applied to any version? ......................................................................... 37
How do I know what is in a software update? ................................................................................ 37
How do I track software updates and versions? ............................................................................ 38
What do I do with old versions of my software? ............................................................................. 38
Quick Start ............................................................................................................................................ 39
Starting TANK ................................................................................................................................. 39
TANK Input ..................................................................................................................................... 41
Index ........................................................................................................................................................... 43

TANK Installation Guide

Contents

TANK Installation Guide

SECTION 1

TANK Installation Guide


This guide provides you with a basic introduction to the TANK software, as well as details about
licensing and installation. The Quick Start section gets you started using the product through the
tank input phase. For more complete information about TANK and analyzing tank models, see
the TANK Users Guide installed with your software.

In This Section
What's New in TANK 2014 ............................................................ 9
Introduction .................................................................................... 10
Additional Intergraph CAS Software .............................................. 10
Licensing ........................................................................................ 13
Using the SmartPlant License Checkout Utility ............................. 23
Install TANK ................................................................................... 27
Troubleshoot Installation ................................................................ 34
Update TANK Software ................................................................. 37
Quick Start ..................................................................................... 39

TANK Installation Guide

TANK Installation Guide

TANK Installation Guide

What's New in TANK 2014


The following changes have been made to TANK 2014:
Version 2014 (6.0)

Updated graphic model to include 3D View.

Updated the software to support API 650, 12th Edition (Errata, July 2013).

Updated the software to support API 2000, 6th Edition (November 2009).

Updated the software to support API 653, 4th Edition (November 2013).

Completed various UI updates.

Added a new Check for Update option for software updates.

Updated Supported Cone Roof Data to include a Structural Database input, which is
separate from the tank-specified database input.

Revised the software to store the Reload Last File at Startup configuration setting in the
registry settings.

Updated Help with information for all enhancements and previous software revisions.

For a complete TANK revision history, see Appendix F - Revision History.

TANK Installation Guide

TANK Installation Guide

Introduction
TANK is a comprehensive, easy-to-use software tool for the design, analysis and evaluation of
oil storage tanks. It provides users with quick and accurate designs for new tanks and evaluation
of existing tanks.
TANK performs calculations in accordance with the latest API Standards, 650 and 653. Analysis
can also include wind, seismic and settlement conditions, as well as calculate air venting
requirements to API 2000 Section 4.3 standards.
The TANK Development Team continuously enhances the software to add new functionality and
to modify existing procedures as industry codes are updated. For more information on the most
recent changes to TANK, see What's New in TANK 2014 (on page 9).
For the latest support information for this product:
Technical Support
Email:

ppmcrm@intergraph.com

ICAS Dealer
Support:

http://www.coade.com/Support/Dealers.shtml

Phone:

1-800-766-7701

Fax:

281-890-3301

Web Sites:

http://www.coade.com
http://www.intergraph.com/ppm/analysis.aspx

Address:

Intergraph CAS
7840 N. Sam Houston Pkwy. W.
Suite 100
Houston, TX 77064

Sales Email:

sales.icas@intergraph.com

Knowledge-Based
Articles/Tutorials
(US & Canada
only):

http://crmweb.intergraph.com/ecustomer_enu

Send documentation comments or suggestions to PPMdoc@intergraph.com.

10

TANK Installation Guide

TANK Installation Guide

Additional Intergraph CAS Software


CADWorx Plant is AutoCAD-based plant design/drafting software with a bi-directional data
transfer link to CAESAR II. CADWorx allows models to be created in orthographic, isometric,
2D, or 3D modes. CADWorx template specifications contain built-in auto routing, auto iso, stress
iso, auto dimensioning, complete libraries, center of gravity calculations, and bill of materials.
CAESAR II is an advanced tool for designing and analyzing piping systems using input forms,
on-line help, graphics, and extensive error detection. CAESAR II statically and dynamically
analyzes large piping models, structural steel models, or combined models.
PV Elite is comprehensive software for the design or analysis of vertical and horizontal vessels.
Pressure vessel codes include ASME VIII-1 and VIII-2, PD: 5500, and EN-13445. PV Elite
includes CodeCalc. CodeCalc is software for the design or analysis of pressure vessel
components. CodeCalc capabilities include: analysis of tubesheets, rectangular vessels,
flanges, nozzles; Zick Analysis; and standard internal/external thickness and pressure
calculations on heads, shells, and cones. API 579 calculations are also included.
PV Fabricator automates the production of pressure vessel fabrication deliverables. When
linked to PV Elite, PV Fabricator improves the workflow and reduces errors.

TANK Installation Guide

11

TANK Installation Guide

12

TANK Installation Guide

SECTION 2

Licensing
TANK supports three types of licensing:

Local External Software Lock (ESL) - Hardware-based licensing using a green USB
dongle. A local ESL can be moved between computers (such as between desktops and
laptops).

Network External Software Lock (ESL) - Hardware-based licensing using a red USB
dongle. A network ESL is installed on a computer that is network accessible from the
computer, or multiple computers, running TANK.

License Manager - Software-based licensing using SmartPlant License Manager (SPLM).


For more information, see SmartPlant License Manager Installation (on page 17). Refer to
the SmartPlant License Manager documentation for complete installation and configuration
instructions.

External Software Lock (ESL) Keys


The External Software Lock (ESL) is the security protection method used by Intergraph CAS,
Inc. The software cannot execute unless an appropriate ESL (green or red USB key) is
connected locally to the computer, or to another computer in the network (red USB key).
The ESL contains the TANK licensing data, and other client-specific information. This
information includes the client company name and user ID number. Additional data may be
stored on the ESL depending on the specific program and the specific client.
There are two different ESL types, local and network. Both types of ESLs are intended to be
attached to the USB ports of the applicable computers. The appropriate ESL(s) are shipped with
your product according to the licensing type purchase.

Local ESLs provide the maximum flexibility in using the software in that they can be moved
between computers (for example, between desktops and laptops).

Network ESLs must be attached to a computer on the network, either a computer or the
server. In order for the network to respond to software requests for the ESL, the NetHASP
License Manager utility must also be running on the computer where the network ESL is
attached.

The HASP drivers for ESL usage can be found in the sub-directory ASSIDRV beneath the
TANK program directory. The documentation files in this sub-directory contain instructions for a
variety of networks and operating systems. Note that there are periodic updates to these ESL
drivers and they can be downloaded from the Intergraph eCustomer
(https://www.crmweb.intergraph.com) website.
Do not connect two locks to the same computer. The software finds the first lock and
returns its code. For example, you have a lock for CAESAR II and CADWorx and plug both into
the same computer. You start CAESAR II, but the software might find the CADWorx lock first
and return an error. If the same computer is going to run more than one Intergraph CAS, Inc.
product, then contact Intergraph CAS by sending an email to
icaslicenserequests@intergraph.com to request that both products be licensed from the same
lock.

TANK Installation Guide

13

TANK Installation Guide

ESL Installation
The following topics explain how to install the different hardware locks supported by TANK.

What do you want to do?

Install a local lock (on page 14)

Install a network lock (on page 14)

Install a local lock


1. Open Windows Explorer.
2. If you are installing CAESAR II, PV Elite, or TANK, navigate to c:\Program Files\Intergraph
CAS\Product\Assidrv and double-click HASPUserSetup.exe.
-ORIf you are installing CADWorx, navigate to c:\CADWorx Version\Product\Assidrv and
double-click HaspHLDriverSetup.exe
3. Follow the on-screen instructions to install the driver.

Install a network lock


The following list details general information about red network ESLs.

14

The red network ESL should be set up by a Network Administrator or someone familiar with
Windows-based networks. If you are not familiar with concepts such as network protocols,
broadcast, IP addresses, TCP, UDP, and Windows Services, please do not attempt to setup
the red network ESL.

The red network ESL does not have to be attached to the network server. We recommend
attaching the red network ESL to a computer that is always up and running, can be
re-booted without impact to users, and is not the primary computer for any user on the
network.

If you install an Intergraph CAS product on a network drive for multiple users to access,
assign read/write privileges for all users to the [Product Folder]\System folder. Intergraph
CAS applications write temporary files to the [Product Folder]\System folder that pertains to
the installation. The [Product Folder]\System folder also needs to have read/write privileges
for all users.

If you are using other network protocols, such as NetBIOS or IPX, check the SafeNet web
site for instructions. The only protocol tested with Intergraph CAS products is TCP/IP.

The information provided in TANK Help file is a supplement to the NetHasp User's Guide,
which is delivered as a PDF(_NETHASP.pdf) in Assidrv folder. Review the PDF file for any
issues not addressed in the Help file.

TANK Installation Guide

TANK Installation Guide


Notes on Network ESLs
A network ESL has advantages and disadvantages. One big advantage is that many client
computers can access the software from a single server. Additional points for consideration are
listed below.

Depending on the number of licenses allowed by the network ESL, some users may receive
error messages when attempting to access the software. For example, if the ESL has been
configured to allow four simultaneous users, an error message stating that no licenses are
available when the fifth user attempts to access the software. Consequently, the fifth user is
not able to access the software until one of the first four users exits the software and
releases a license.

Because of the communication procedures between the client computer and the file server,
memory access to the network ESL is much slower than to a local ESL. This access time
delay only occurs when the software is first started after installation.

Because there is no network specific version of the software, the software looks first for a
local ESL, and then for a network ESL. This allows both a network ESL and several local
ESLs to be used on the same system. This transparent ESL access procedure allows a
single version of the software to be used on the network and on remote computers.

We recommend that only 70 to 80 percent of the required licenses be assigned to a network


ESL, with the remaining 20 to 30 percent assigned to local ESLs. This enables the local ESL
to be moved between computers. If all of the licenses are on the network ESL, a user must
be logged into the network to access the software. As such, a few local ESLs provide much
greater operating flexibility.

NetHASP License Manager / NETHASP.INI Instructions


You must have Administrator privileges to perform the following procedure.
1. Attach the red network hardware lock to the parallel port or USB port of the computer.
2. On the computer where the hardware lock is attached, navigate to the [Product
Folder]\Assidrv folder and double click Lmsetup.exe. Follow the on-screen instructions to
install the NetHASP License Manager as a service.
3. The NetHasp License Manager starts automatically each time you re-boot the computer.
This occurs because the NetHasp License Manager is set up as a start up service inside
Windows XP/Vista/7. To verify that the service is running, click Start > Control Manager >
Administrative Services, and then double-click Services. In the Services dialog box,
locate HASP Loader in the Name list. The HASP Loader Service starts even if no one logs
into the computer.
4. Determine what protocols the NetHasp License Manager is listening to. The NetHasp
License Manager displays a message similar to those list below:
Server is listening to IPX : Loaded
Server is listening to TCP/IP : Loaded
Server is listening to NetBIOS : Loaded
Loaded means that this protocol is active on the computer.
5. Open the Activity Log menu. This displays the activity log that confirms which protocols are
loaded. Do not be alarmed if the activity log reports that the NHSRV.ini file is not found.

TANK Installation Guide

15

TANK Installation Guide


6. Use the box in the top-left corner of the activity log to display only the information specific to
each protocol. Open the activity log for the protocol you want to use, and verify that it
contains no error messages.
7. For TCP/IP protocol, the activity log should report something similar to the following:
Server IP address: 111.111.111.111
Server Host Name: PDC_NT01
8. To speed up response time to the network key, use the Remove menu to unload any
protocols that you are not planning to use with the NetHasp License Manager.

Modify NetHASP.ini for TCP/IP Protocol


If you still cannot access the network ESL you need to configure this NetHASP.ini
file. You must know the IP address of the computer where the red network hardware lock is
attached. All lines with a semi-colon at the start are considered not used.
1. Modify the NetHASP.ini file, located at in the [Product Folder]\Assidrv folder under
[NH_COMMON], as follows:
a. NH_TCPIP = Enabled
AND under [NH_TCPIP]
b. NH_SERVER_ADDR = 111.111.111.111
c.

NH_USE_BROADCAST = Disabled

You may also have to modify other entries in the [NH_TCPIP] section depending on
your network setup. The most common entry to modify is NH_TCPIP_METHOD.
2. Copy the NetHASP.ini file to the AutoCAD folder.
Example: C:\Program Files\AutoCAD
Example: C:\Program Files\Autodesk\AutoCAD
3. For CADWorx Design, copy the NetHASP.ini file to the [Product Folder]\Intergraph
CAS\CADWorx Design folder.
4. Start TANK.

Troubleshooting Network Locks


1. Verify that the NetHasp License Manager is running on the computer where the red network
ESL is attached.
2. Verify the protocols that NetHasp License Manager is broadcasting. Make sure that these
protocols are installed on the client computers.
3. Install and run the Monitor Utility. This file, NetHASPMonitorSetup.exe, is located in the
[Product Folder] Assidrv folder. If NetHASP Monitor cannot find the red network ESL, then
TANK cannot find the red network ESL.

16

TANK Installation Guide

TANK Installation Guide

SmartPlant License Manager Installation


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

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

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

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

TANK Installation Guide

17

TANK Installation Guide


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.
During SmartPlant License Manager installation automatically turns on a product
usage log file in C:\Win32App\Ingr\SPLM\bin\loggingfileV12.txt. You can
change this location and name of this file as it can grow to be a large file. If you stop and
restart logging, you need to define the output location.
This file can grow very large and users can redefine the location and name of this file.
2. Select SmartPlant License Manager Installation.
3. Click Next on the Welcome to the InstallShield Wizard for SmartPlant License Manager
page.
4. Enter your name and company name in the User Name and Company Name fields on the
Customer Information page. Click Next.
5. 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.

18

TANK Installation Guide

TANK Installation Guide

Silent Mode and SmartPlant License Manager Installation


Quick Installation Workflow
Use this workflow for all products that require SmartPlant License Manager concurrent licensing.
The System Administrator completes or gives guidance about most of these steps. Administrator
rights are required to install and setup SmartPlant License Manager. If you need more
information, follow the detailed procedures in the other sections. For more information, refer to
Frequently Asked Questions (FAQ), Functions of SmartPlant License Manager, and
Troubleshooting and Error Messages.
Please refer to the delivered SmartPlant License Manager Readme for all the latest
product installation updates.
1. Designate a computer as the SmartPlant License Manager license computer. This computer
must be on the network and have a name with no spaces and a static IP address.
2. Install SmartPlant License Manager on the license computer and generate a computer ID.
3. Request a license key from the Intergraph Order Desk or generate a license key using
eLicense.
4. Click Start > Programs > Intergraph SmartPlant License Manager > SmartPlant
License Manager.
5. Click Install and Remove and Install License Key commands.
6. Click License Machine and enter the license key you received. If the license key installs
correctly, SmartPlant License Manager software automatically closes.
7. Next, install SmartPlant License Manager on each client computer.
8. Click Start > Programs > Intergraph SmartPlant License Manager > SmartPlant
License Manager.
9. Click Configure and Test and Select License Machine for Client.
10. Enter the SmartPlant License Manager computer name. Exit SmartPlant License Manager.
11. Install the software that requires licensing. For example, SmartPlant Review, PDS or
SmartPlant P&ID. Use that product's installation and configuration guides to install each
product.
12. Use the Test Seat Reservation and Test Seat Release commands to ensure that
communication is working between the license computer and the client. Successful
messages show appropriate communication.
13. Click Test Seat Reservation. Select the license computer name and Batch or Interactive
mode. Note the seat number in the SmartPlant License Manager Information dialog box to
enter.
14. Click Test Seat Release and enter the seat designated in the SmartPlant License Manager
Information dialog box.
15. Start the software product that requires SmartPlant License Manager licensing.
16. For information about firewalls, please refer to Appendix E: Microsoft Windows Firewall
and SmartPlant License Manager.

TANK Installation Guide

19

TANK Installation Guide


See Also
General Topics FAQ (on page 21)

Frequently Asked Questions (FAQ)


Refer to the SmartPlant License Manager FAQ on the Web in the eCustomer system for the
most current FAQ. It is continually updated. Click
https://crmweb.intergraph.com/ecustomer_enu and select Services > Download Software
Updates > Products > SPLM.
Will providing the Machine ID make my computer less secure?
No. The Machine ID allows the license manager to uniquely identify your computer from a
collection of hardware and software identifiers without explicitly publishing your computer's
TCPIP address. Because the computer identifier cannot be used like a TCPIP address, it is
actually more secure than publishing your computer's TCPIP address.
Where can I find SmartPlant License Manager and other products to download?
SmartPlant License Manager is available from the following web page:
https://crmweb.intergraph.com
Select Services > Download Software Updates > Products > SPLM.
You do not need a serial number to install SmartPlant License Manager.
Can I divide the licenses for one LAN into several license computers for the purpose of
managing project access, for example, or as coverage in the event that my license
computer goes down?
Yes, you can divide the licenses.
What happens if I install the new license key prior to expiration of the old license key?
The new license will overwrite the existing key independent of the expiration date.
Is my existing key still running if I regenerate the Machine ID?
Yes, but you will not be able to reinstall the old key. You will need to request a new key for
the new machine identifier.

See Also
Purchasing Licenses FAQ (on page 20)
General Topics FAQ (on page 21)
PDS, FrameWorks Plus, and ISOGEN FAQ

Purchasing Licenses FAQ


Do I have to request a software upgrade from my local office before requesting a license?
No, you can request licenses without upgrading the software. If you are upgrading software,
you must request the upgrade before you request licenses. A license request does not
include a software upgrade and a software upgrade does not include a license request.

See Also
General Topics FAQ (on page 21)

20

TANK Installation Guide

TANK Installation Guide


General Topics FAQ
What is a license machine?
The license machine is the computer where the license key is loaded; it can be a standard
computer or a server. The license key tells the license machine how many licenses it can
issue. Clients of a license machine are computers where SmartPlant License Manager is
installed and pointing to the license machine. The computer where you start the software
(for example, PDS or SmartPlant P&ID) asks the license machine for a license. If a license
is available, the license machine provides it. If all licenses are in use, the client is not
granted a license.
How can I tell what version of SPLM was used in the Machine ID or license key file?
Please check the starting number in your Machine ID or license key. See the table below.
Version

Machine ID starts with

License key starts with

2012 (v12)

2010 (v11)

2008 (v10)

Do I have to have one license computer for each LAN?


No, your configuration is entirely up to you. A persistent network connection is required if
you want to connect to a license server that belongs to a different LAN.
Can I make an educated guess at my installation date?
Yes. Intergraph provides a key within 48 hours of receipt of your request (via mail or phone).
Please ensure that the date you request is the actual date that you install the key, making
sure that all necessary software is available and loaded before that date. We request that
you notify us as early as possible.
What happens if my license machine goes down?
You are unable to check out licenses from this machine until it is back in use. Processes
that already have licenses checked out are not affected by the fact that the license computer
is unavailable.
It is possible in critical situations to request emergency licenses from Intergraph. They are
installed on the client computer rather than a licensing machine. Contact Intergraph Support
at 1-800-766-7701 or your local Intergraph office for more information.
What happens if the license machine is rebooted in the middle of my design session?
Nothing. Licensing does not depend on maintaining a continuous communication link to the
license computer.
What happens if my local computer goes down after I've obtained a license?
If the scavenger cannot contact the client computer during scavenging, the license is
marked for a 16-hour hold before it is released. The scavenger periodically advances this
16-hour timer for each license. It is important to schedule the scavenger to run regularly, at

TANK Installation Guide

21

TANK Installation Guide


least every hour or two. If the client is in contact sooner, the hold is voided and normal
scavenging takes over.
I am running out of licenses earlier than I believe I should be. How can I troubleshoot to
understand what is happening?
Have your users click Scavenge for Keys on the Scavenge Options dialog box or you can
type pdlice -n in a Command Prompt window.
If you think that client nodes are improperly holding onto licenses, examine the results of the
pdlice -M command. This shows you which client nodes have licenses checked out. If a
client computer has no plant design-related activity and it is still holding licenses, rebooting
that client and then scavenging from the license computer may free some licenses.
If possible, find out what was processing when the job stopped. This information can help
you and/or Intergraph determine the underlying cause of the termination. Save the output of
any scavenging process that returns a license. This information provides the reasons why
the license was returned. The output of the scavenger includes the following information:
nodename, product tag, batch mode (Yes/No), process ID, and checkout time.
What do I type to see the number of licenses?
Click Show Key Status from the Display Options dialog box to show the status of your
keys.
How can I tell who is using a license?
Click Display Status of Reserved License on the Display Options dialog box or in the
license log file.
We installed a key for three licenses, but we can operate only two licenses at the same
time. Why?
There can be several reasons.
Click Display Status of Reserved License on the Display Options dialog box to
determine the number of licenses that your key contains.
Click Scavenge for Keys on the Scavenge Options dialog box to scavenge for the third
license that you are unable to use.
Verify that clients and servers can telnet to each other. Look for anomalies such as two
nodes on the network with the same name or the reuse of an old name for a new computer,
but with some traces of the old computer still existing in files on the network.
When an application is on a computer that is disconnected from the network without
exiting the product, how long is the license held?
16 hours.
How long would a daily license last?
Daily license expires after 12 hours.

See Also
Purchasing Licenses FAQ (on page 20)

22

TANK Installation Guide

TANK Installation Guide

Using the SmartPlant License Checkout Utility


The SmartPlant License Checkout utility (License Checkout Utility.exe) allows you to obtain
licenses for Intergraph ICAS products for use on a non-networked computer (for example, a
remote laptop). Using this utility allows you to run ICAS products without a network connection
to the license machine. Each user on a server can check out a license from that server.
When you check out a license, the license and expiration information are stored on your local
machine, separate from other license and expiration information. A license is available only for
the user that checks out the license. Each time you start the product during the checkout period,
a message displays the expiration date for the checked out license.
When the checkout period for the license expires, the ICAS product attempts to request a
license using SmartPlant License Manager the next time you start the product. For example,
after the license expires at 11:59 PM on the expiration date, the next time you start the product,
it attempts to access the SmartPlant License Manager license machine for base and module
licenses prior to running.

You must install and configure SmartPlant License Manager before checking out a license.

You must have administrator privileges to setup and install the utility.

Install SmartPlant License Checkout Utility


Do not uninstall the version of the SmartPlant License Checkout Utility that is
currently on your system if you (a) are installing a new product that includes SmartPlant License
Checkout Utility v11, or (b) have other applications such as SmartPlant Review or SmartSketch
loaded on your machine.
The older version of the SmartPlant License Checkout Utility is needed to work with your
currently-loaded application(s). Refer to the compatibility matrix chart on eCustomer for
information on application versions and their required version of the SmartPlant License
Checkout Utility.

Install the Utility


1. Insert the product disc. If the installation does not start automatically, double-click setup.exe
in the main folder.
For ICAS products, locate the SmartPlant License Checkout Utility installation
program in the Other Installs folder of the product DVD.
2. Click SmartPlant License Checkout Utility Installation.
3. Type your name and company name.
4. Verify your name and company name, and then click Next.
5. Click Display to read and accept the license agreement, and then click Yes.
You must have a PDF reader to view the license agreement.
6. Specify the destination folder.

TANK Installation Guide

23

TANK Installation Guide


7. Review your settings, and then click Next.
8. Click Install to start the installation process.
9. Click Finish.

You can uninstall the License Checkout utility at any time, even if you are currently running
a product in remote license mode.

If you installed the latest version of the SmartPlant License Checkout Utility (v11), it is
installed along with the older version you have:

License Utility Checkout Dialog Box


Specifies the product for which you want to check out a license.

Options
Application Group - Displays the installed products available for license checkout. Select the
product for which you want to check out licenses.
If the Application Group list is empty, your application requires an older version of the
checkout utility. Please check your original product installation media for the compatible version
of the utility.
Available Modules - Displays any modules or add-ins available with your product. If no
modules appear in the list, either your product contains no supported modules, or no modules
have been installed. Check the box beside the module for which you want to check out a
license, and then click Check Out. If you want to check out only the base product, do not check
any of the modules.
License Expiration - Specifies the date that you want the checkout to expire. When the
checkout period for the license expires, the product returns to normal and connected license
operation using the SmartPlant License Manager the next time you start the product.

Check Out a License for TANK


Be sure that the SmartPlant License Manager (SPLM) is installed and configured on your
computer.

To check out a license for TANK


1. Click Start > Programs > Intergraph SmartPlant License Checkout Utility > License
Checkout Utility.
The SPLM Checkout Utility (see "License Utility Checkout Dialog Box" on page 24)
dialog box opens.
2. In the Application Group list, select TANK.
You must close the TANK application when checking out a license.

24

TANK Installation Guide

TANK Installation Guide


3. In the Available Modules list, click the checkbox for each module you need.
TANK users must check out all listed TANK modules for the software to function
correctly.
4. Select an expiration from the License Expiration list, and then click Check Out.
The checkout utility searches for an available license.

You may experience a delay as the utility checks the network for available licenses.
When you open TANK the status of the checkout license displays at the bottom of the TANK
main window. When you are on the last day of your license checkout, the status displays
you have zero days remaining.
Once you check out a license, it cannot be checked in. If you check out three modules (four total
licenses: one base and three modules), then attempt to run the License Checkout Utility again
and select two other modules, the software displays a dialog box that notifies you that a license
is already checked out for TANK and displays the expiration date for that license.
When running in remote license mode, you cannot use setup to modify the product installation
until the following conditions are met:

The checkout duration expires.

The system is working with SmartPlant License Manager in connected license mode once
again.

In other words, you cannot install or remove modules while running in remote license mode.
If TANK is running in remote license mode but is unable to confirm for any reason that it is
running in that mode, TANK automatically returns to connected license mode and attempts to
obtain the licenses from SmartPlant License Manager. TANK notifies you if it is unable to obtain
licenses from SmartPlant License Manager.
Each time you start TANK while using remote license mode, the software displays a message
informing you when the checked out licenses expire. The first time that you run TANK after the
checked out licenses expire, the software displays a message informing you that the checked
out licenses have expired and that the software is reverting to the standard connected license
mode and attempting to get licenses from SmartPlant License Manager.

TANK Installation Guide

25

TANK Installation Guide

26

TANK Installation Guide

SECTION 3

Install TANK
Prior to installing TANK, verify that your computer meets the required hardware and software
requirements. For more information, see Before You Begin Installing the Product (on page 27).
The TANK installation DVD contains the following options:

Install TANK- Launches the main installation process, which installs TANK, the HASP
drivers, and all associated documentation.

TANK Information - Opens the TANK Product Details page on the Intergraph CAS web
site.

ReadMe File - Opens a text file discussing the installation steps, the system requirements,
and the DVD contents.

License Agreement - Opens an RTF file containing the TANK License Agreement.

HASP Network Licensing Overview - Opens a DOC file containing a summary of the
Aladdin (SafeNet) HASP Licensing System.

HASP Trouble Shooting - Opens a DOC file containing troubleshooting procedures for
issues with HASP licensing.

DVD Content:

Browse the DVD - Displays the DVD contents in Windows Explorer.

Additional Products - Displays additional Intergraph CAS products.

Contact Intergraph - Displays contact information for Intergraph CAS Support.

Services:

Training - Opens the TANK Course Details page on the Intergraph CAS web site.

Support Forum - Opens the TANK Discussion Forum on the Intergraph CAS web site.

TANK Installation Guide

27

TANK Installation Guide

Before You Begin Installing the Product


Complete the following checklist before you install TANK:

Review the hardware and software requirements that follow to ensure that your system
meets the requirements to begin the TANK installation.

Close all other software before running the TANK installer. Most unsuccessful installations
are caused by other software running at the same time as the installer.
The product installation is a DVD. The product DVD is not readable in a CD drive.

Hardware/Software Requirements
Processor

Intel Pentium IV or higher

AMD Athlon dual-core processor

3.0 GHz or higher

Memory

2 GB RAM for Windows XP

4 GB RAM for Windows Vista or Windows 7

Display

Video card with at least 256MB video RAM

Video card support for OpenGL 1.1 or later

Video card support DirectX 9.0 or later

Video card drivers updated with the latest manufacturer's drivers

1280 x 1024 minimum resolution with TrueColor

Operating System

28

Windows 7 Ultimate, Enterprise or Professional (32 bit / 64 bit)

Windows Vista SP2 Ultimate, Enterprise, or Business (32 bit / 64 bit)

Windows XP SP3 Professional (32 bit)

Windows Server, Starter, and Home editions are not supported for installation of the main
application. Windows Sever version is only supported for the installation of network licensing
system.

TANK Installation Guide

TANK Installation Guide

Install TANK from the Media


Close all other software before running the TANK installer. Most unsuccessful installations are
caused by other software running at the same time as the installer.
1. Insert the Intergraph TANK DVD. If the DVD does not start automatically, double-click Run
CD_Main.html in the Autoplay dialog box or in the root folder of the DVD.
The TANK launch screen opens in your default internet browser.
The installation DVD is not readable in a CD drive.
2. Click Install TANK.
3. Click Next on the Welcome to the Installation Wizard for TANK screen.
4. Carefully read the license agreement on the License Agreement screen.
5. Click I accept the terms in the license agreement, and then click Next.
6. On the Customer Information screen, enter information in the User Name, Organization,
and Serial Number boxes. Intergraph CAS, Inc. includes the serial number in your product
shipment. Click Next.
7. On the Destination Folder screen, review the default installation folder path. If needed,
click Change and select the folder location. Click Next.
8. On the Select License Type screen, specify the license type that you have: network ESL,
local ESL, or SPLM license. For more information, see Licensing (on page 13).
9. On the Ready to Install the Program screen, click Install to begin installing the software.
As the installation progresses, the installer displays in a series of progress bars. If an ESL
license type was selected, the Aladdin device driver installation begins. Click OK on each
dialog box.
10. Click Finish to exit the installer.
11. In the Installer Information dialog box, click OK to restart the computer and complete the
installation.
You must restart your computer for TANK to run correctly.

Install TANK on a Network


Network ESL
A network ESL must be attached to the USB port of a computer on the network, such as a
workstation or a server. A server is a better location for this ESL because it is usually always
running. If the network ESL is attached to a workstation, the workstation must be running and/or
logged onto the network before anyone can use the software.
For a network ESL, you must load utility software on the computer where the ESL is installed.
The utility used depends on the type of network and whether the ESL is on a server or a
workstation. The installer and instructions for network ESL usage are found in the SetupESL
folder on the Intergraph TANK DVD.
There are advantages and disadvantages to using a network ESL. The main advantage is that
many users (up to the number of licenses) have access from a variety of computers, while the

TANK Installation Guide

29

TANK Installation Guide


ESL is on a single server. The main disadvantage is that you cannot move the ESL between
computers in order to take the software to a remote location.
A network and several local ESLs can be used on the same network because there is no
network-specific version of the software. We recommend that only 70 to 80 percent of the
licenses be assigned to a network ESL. Assign the remaining 20 to 30 percent of the licenses to
local ESLs. The local ESLs can then be moved between computers to run the software at
remote locations.

Novell File Server ESL Installation


If the network ESL is located on a Novell file server, the driver HASPSERV.NLM is needed.
Copy this driver to the file server into the top level SYSTEM directory. Modify the system startup
file (AUTOEXEC.NCF) to include the command LOAD HASPSERV.
You can use SYSCON (or equivalent) with Supervisor rights to perform this modification.

Novell Workstation ESL Installation


If the network ESL is located on a workstation, the driver HASPSERV.EXE is needed. Copy this
driver to the workstation. The folder location on the workstation is not important, as long as the
driver can be located at startup. Place the HASPSERV command in the AUTOEXEC.BAT file of
the workstation, after the commands which load the network drivers.
The workstation does not need to be logged in, but it must always be up and running for
you to access the ESL and open TANK.

Windows Server Installation


For a Windows server installation, see Nethasp.pdf and ESL_RED.txt in the SetupESL folder of
the Intergraph TANK DVD.

Software Installation on a Network Drive


The installation program treats a network drive no different than a local hard drive. Simply
specify the target installation drive and folder and the software will be copied and expanded
accordingly.
Some networks protect installation directories from subsequent modification by users. This
involves setting the access rights to the installation folder to read, share, and scan. Because
Intergraph CAS, Inc. software uses data files specific to the installation (that is, accounting files,
material files, and so forth) which a user may need to modify, these files cannot be located in the
protected installation folder. Therefore, these data files are located in a subfolder named
SYSTEM, underneath the installation folder. Users should be given all access rights to this
SYSTEM folder. (While the actual name of the program's installation folder can be specified by
the person installing the software, the SYSTEM subdirectory name is fixed, and is automatically
created. Renaming this subfolder will cause the software to fail and generate an error report.
Note that this SYSTEM subfolder is not the primary top level SYSTEM directory containing the
network operating system. Consult your system administrator for clarification.
After the software has been installed on the network drive, the installation program launches the
configuration program which generates a default configuration file. After the installation folder is
write protected this file cannot be modified. (This is actually a good idea, because this
configuration file can then only be used as a starting template to generate other configuration
files located in the various user data directories.)

30

TANK Installation Guide

TANK Installation Guide

ESL Installation on a Network


Intergraph CAS software programs support "local" ESLs and "network" ESLs. Both types of
ESLs are intended to be attached to the USB ports of the applicable computers. The local ESLs
provide the maximum flexibility in using the software, because these devices can be moved
between computers (such as between desktops and laptops). If your computer uses a local
ESL, you can skip the remainder of this section.
The network ESL must be attached to the USB port of a computer on the network (this can be a
workstation or the file server). The file server is a better location for this ESL, because the
computer is usually always on. If the network ESL is attached to a workstation, the workstation
must be running and/or logged onto the network before anyone can use the software.
In order for the network to recognize the ESL, you must load a utility program must be loaded on
the machine controlling the ESL. The actual utility used depends on whether the ESL is on the
file server or a workstation and the type of network. The drivers for network ESL usage can be
found in the sub-directory ASSIDRV beneath the TANK program folder. The documentation files
in this sub-folder contain instructions for a variety of networks and operating systems.

Windows Server Installation


For a Windows server installation, refer to the documentation files NETHASP.TXT and
ESL_RED.TXT found in the Assidrv subfolder for network specific instructions.

Network ESLs Notes


There are advantages and disadvantages to using a network ESL. The prime advantage is that
many users (up to the number of licenses) have access (from a variety of computers) to the
software on a single server.
The main disadvantage is that users cannot transfer the ESL between computers in order to
take the software to a remote location.
Because both a network and several local ESLs can be used on the same computer (there is no
network-specific version of the software), we recommend that only 70 to 80 percent of the
licenses be assigned to a network ESL. The remaining 20 to 30 percent of the licenses should
be assigned to local ESLs. This enables the local ESLs to be moved between computers to run
the software at remote locations. Alternatively, if all of the licenses are on the network ESL, a
user must then be logged into the network to access the software. A few local ESLs provide
greater flexibility.

TANK Installation Guide

31

TANK Installation Guide

Install TANK in Silent Mode


You can use the Windows Installer to install and uninstall TANK using a command line instead
of the normal installer interface. You can then perform an unattended installation without dialog
boxes, such as when performing a network installation or a corporate repackaging. The
following command line arguments and parameters can be used with Windows Installer
(msiexec.exe) and the TANK setup (setup.exe) to perform a silent installation of the product.
1. Click Start > All Programs > Accessories > Command Prompt.
The Command Prompt screen opens.
2. Enter the drive letter where the TANK DVD is located. For example, type:
E:
3. Change the path to the TANK folder where Setup.exe is located on the DVD. For example,
type:
cd TANK
4. Enter the installation command:

For silent installation with English language and green ESL color, type:
Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="Green"
SERIALNUMBER="<serial_number>""

For silent installation with Red ESL color and ESL installed locally, type:
Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="Red"
ESL_ON_MACHINE="Yes" SERIALNUMBER="<serial_number>""

For silent installation with SPLM, type:


Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="SPLM"
SERIALNUMBER="<serial number>""

For silent installation with customized path, type:


Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="SPLM"
SERIALNUMBER="<serial number>" INSTALLDIR=\"<path>""

Arguments
/v - Pass msi commands
/qb - Silent installation with basic user interface

Parameters for Setup.exe


INSTALL_SILENT - Sets silent installation.

Yes - Installation is silent.

No - Installation is not silent

LANG - The language to install.

32

Eng - English

Span - Spanish

TANK Installation Guide

TANK Installation Guide

Ger - German

Fren - French

SERIALNUMBER - The product serial number provided to you by Intergraph CAS.


ESL_COLOR - The ESL license type.

Red - Network ESL

Green - Local ESL

SPLM - SmartPlant License Manager (no ESL)

ESL_ON_MACHINE - Only used when ESL_COLOR is Red. Identifies the ESL location.

Yes - ESL is on the local machine.

No - ESL is on the server.

INSTALLDIR - The path to load the installation files.

The general format of the command is:


setup.exe /v"/qb PROPERTY_NAME="value" PROPERTY_NAME2="Value""

For a complete list of command line arguments for msiexec.exe, type the following in a
Command Prompt window: msiexec.exe /?

For a complete list of command line arguments for setup.exe, type the following in a
Command Prompt window: setup.exe /?

TANK Installation Guide

33

TANK Installation Guide

Verify the Installed TANK Program Structure


A typical TANK hard disk configuration is structured as follows after TANK completes
installation:
TANK:

Root Installation TANK directory

Project #1:

Data files for Project #1

Project #2:

Data files for Project #2

\SYSTEM:

Program database & control files

\EXAMPLES:

Sample input files

Most files in the data subdirectories are identified by a user-defined filename with a given
extension. The remaining files hold data controlling the software's operation. These files and
their descriptions follow:

34

jobname.tki

TANK input file

jobname.log

Internal file that is created by the solution module

jobname.tko

Temporary results file

jobname.T80

Results file used by the Output Processor

jobname.tke

Error check report

units.FIL

User units file (relates user units to program units)

*.BIN

TANK Material Database

UMAT.BIN

Binary file holding the user-defined materials

TANK Installation Guide

TANK Installation Guide

Troubleshoot Installation
The following section details quick resolutions to TANK installation issues.

Why do I get an error message saying TANK cannot locate the


configuration file when I try to run TANK?
The Windows 8 platform installs with .NET Framework 4.0 by default. However, TANK requires
.NET Framework 3.5.1 to run. From Windows 8, you can enable .NET Framework 3.5.1 through
the Control Panel.
You must have an Internet connection to enable .NET from the Windows Control Panel.

To enable .NET Framework 3.5.1


1. Close TANK.
2. From the Control Panel, click Programs.
3. In Programs and Features, click Turn Windows features on or off.
4. Select Microsoft .NET Framework 3.5.1 and click OK.
5. Run TANK.

Why does the TANK Configuration Editor not open?


Why does the Configuration Editor not save and close?
If the Configuration Editor does not open or will not save and close as it should, you should
look at your User Account Control (UAC) settings through the Windows Control Panel.
Decrease the level of your UAC notifications in the Control Panel>System and Security
settings.
Make sure that the TANK system folder has read/write access for your user account.
In addition, verify that you have the system 32 path included in your Windows Environment
Variables.

To add the system 32 path to your Environment Variables


1. Close TANK.
2. Right-click on Computer and select Properties>Advanced system settings.
3. From the Advanced tab, select Environment Variables.
4. Select Path in the System variables list and click Edit.
5. Add the following path to the Variable value and click OK.
c:\Windows\system32\;
6. Run TANK.

TANK Installation Guide

35

SECTION 4

Update TANK Software


Intergraph CAS, Inc. software products are not static; they change continually to reflect
engineering code addenda, operational enhancements, user requests, operating system
modifications, and corrections. New versions are planned and targeted for a specific release
date. However, there may be corrections necessary to the currently shipping version, before the
next version can be released. When this occurs, an update to the currently shipping version is
made. This update is referred to as either a hotfix or a service pack.
A hotfix resolves one or more specific problems, while a service pack typically contains a
significant number of product fixes. Hotfixes have undergone a quick investigation and
resolution with limited regression testing. However, hotfixes have not gone through the formal
software testing and verification protocol. All hotfixes issued on the eCustomer website
(http://www.crmweb.intergraph.com) are included in the next fully-certified product release
(either a service pack or a full version). When issues occur that require a service pack update,
the update is finalized, announced, and posted to the eCustomer website.
Some Intergraph CAS, Inc. users have expressed concern over tracking, archiving, and
distributing the various update generated between major releases. In order to alleviate this
problem for our users, all service packs for new releases contain all previous service pack
updates. In other words, service pack update Y contains update X. This increases the download
size and time required to obtain the update, but only one update is required at any given time.

How do I find out about software updates?


When a service pack update to the software becomes available, all users who have registered
the software are sent an email announcement. Therefore, it is imperative that you register the
software following installation.

How do I download a software update?


Software updates (builds) are available for download through our Customer Support website,
eCustomer (http://www.crmweb.intergraph.com), and are arranged in sub-folders by program.
Each file contained in the folder includes a description, its size, and the creation date.

Can software updates be applied to any version?


A software update is intended for a specific version of the software. As new versions are
released, additional input items become necessary and must be stored in the program data files.
In addition, file formats change; databases grow, and so on. Applying a software update on a
different version of the software (without specific consent from Intergraph CAS, Inc. personnel)
puts your software integrity at risk.

How do I know what is in a software update?


Each service pack update of the software includes a file named BUILD.TXT. This is an ASCII
text file that can be viewed with any text editor or spooled to a printer. This file contains a
description of all corrections and enhancements that have been made to the software since the
original release of this specific version. When necessary, additional usage instructions are
included in this file.

TANK Installation Guide

37

TANK Installation Guide

How do I track software updates and versions?


When a new software update is released, the File > Help screen is revised to reflect the build
number. This allows you to see, from the File tab, which build is in use.
Some updates my only change certain modules of your software. To see which program
modules have been modified, you can run the Intergraph CAS, Inc. Program Scanner utility
from within the TANK program folder. By running this utility and reviewing the results, you can
see which modules have been patched or updated and to what build number.
Select the Program Scanner command on the Diagnostics tab. This utility scans each of the
EXE modules in the program directory and lists the size, memory requirements, and build
number for each. The following shows an example of the results the Program Scanner returns.

What do I do with old versions of my software?


When Intergraph CAS, Inc. releases a new version of the software, you should still keep the
distribution DVD or CD from the previous release. Additionally, be sure to archive any builds
obtained with the original DVD or CD. This allows full usage of this version at some later time, if
it becomes necessary.
To reinstall an older version of the software, first install the distribution DVD or CD. Then, install
the latest update. Each update includes the modifications made in all previous updates.

38

TANK Installation Guide

TANK Installation Guide

SECTION 5

Quick Start
This section provides instructions on how to start TANK. It is assumed that the software has
been properly installed and configured. For more information about configuring TANK, see the
TANK User's Guide.

Starting TANK
Click Start > Intergraph CAS > TANK [version number] > TANK [version number], or you can
double-click the desktop icon
.
The TANK ribbon bar and panels are the control center from which jobs can be selected,
defined, analyzed, and reviewed. For more information, see TANK Interface.

Use the various commands to specify or update the input. After the input has been defined using
the commands on the Input panel, it must be error checked by select Error Check and
Analyze (F12)
on the Analyze panel. The error checker validates the data for numeric
consistency (for example, diameters and thicknesses must be positive), and to enforce API code
requirements (such as thicknesses cannot be less than the course above).
If there are errors in the input data, TANK does not analyze the job. You must correct these
errors before proceeding. The software accepts warning messages and proceeds with the
analysis. However, you should review all warning messages to confirm they are acceptable to
the current tank analysis. For more information, see Check the Input for Errors.
Assuming that error checking completed successfully, TANK begins the analysis of the job.
Once analysis is complete, the software opens the Output Processor so that you can review
the analysis report results.

TANK Installation Guide

39

TANK Installation Guide


You do not need to re-run the analysis prior to opening the Output Processor, unless
the tank input data changes. You can open and view tanks analysis reports as many times as
necessary to interactively review the results.

When you are finished reviewing the output, exit the Output Processor to return to the main
TANK window.
The steps outlined above are summarized below.
1. Start > Intergraph CAS > TANK [version number] > TANK [version number].
2. Select File > New or File > Open to create a new tank job or to select and use an existing
job.
3. Enter the tank input data.
4. Analyze the input data by selecting Error Check and Analyze (F12) from the Analyze
panel.
TANK checks for any errors in the input and then analyzes the job. When the software
completes the analysis, TANK opens the Output Processor where you can view tank
analysis reports.

40

TANK Installation Guide

TANK Installation Guide

TANK Input
The first step in the design or analysis of a tank is to generate an input file, which describes the
characteristics of the tank. Each tank requires an input file with a unique job name for each
configuration to be studied. All of the tank particulars and descriptive information are stored in
this input file. The input file name consists of the job name as the prefix, followed by a .TKI
extension.
Start the input process by selecting File > New or File > Open (and browsing to select an
existing TANK file) and then choosing any option from the Input panel.

TANK separates the input data into logical categories. Each category addresses a specific code
requirement on design task. You must enter tank input data using the General Tank Data
command to save the tank input file. For more information on tank input data commands, see
the Input Panel section in the TANK User's Guide.
As with most software programs, there is an option to save the current state of the input data to
a file. With TANK, you can save the input by using File > Save, or by clicking Save . Save
your input frequently during any extended editing session. When you begin an analysis the
software also saves the data automatically, but it is always best to save the data yourself too.
When you are finished defining the input for your vessel, use the Analyze panel to verify and/or
analyze the job.
For more information, review the other TANK commands in the TANK User's Guide, and then
see Build a Tank Vessel.

TANK Installation Guide

41

TANK Installation Guide

42

TANK Installation Guide

Index
A
access rights 30
Additional Intergraph CAS Software 11
API-2000 41
auto-run feature 27

B
Before You Begin Installing the Product 28

C
Can software updates be applied to any
version? 37
Check Out a License for TANK 24

E
ESL Installation 14
ESL Installation on a Network 31

F
Frequently Asked Questions (FAQ) 20

G
General Topics FAQ 21

H
Hardware/Software Requirements 28
How do I download a software update? 37
How do I find out about software
updates? 37
How do I know what is in a software
update? 37
How do I track software updates and
versions? 38

I
input file 41
Input Menu 41
Install a local lock 14
Install a network lock 14
Install SmartPlant License Checkout
Utility 23
Install TANK 27
Install TANK from the Media 29

TANK Installation Guide

Install TANK in Silent Mode 32


Install TANK on a Network 29
installation 27
Introduction 10

L
License Utility Checkout Dialog Box 24
Licensing 13

N
NetHASP License Manager / NETHASP.INI
Instructions 15
Notes on Network ESLs 15

P
Program Support 37
Purchasing Licenses FAQ 20

Q
Quick Installation Workflow 19
Quick Start 39

S
SmartPlant License Manager Installation
17
Software Installation on a Network
Drive 30
Starting TANK 39

T
TANK Input 41
TANK Installation Guide 7
Troubleshoot Installation 35
Troubleshooting Network Locks 16

U
Update TANK Software 37
Using the SmartPlant License Checkout
Utility 23

43

Index

V
Venting Data 41
Verify the Installed TANK Program
Structure 34

W
What do I do with old versions of my
software? 38
What's New in TANK 2014 9

44

TANK Installation Guide

You might also like