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 Licensee’s internal non-commercial use. Intergraph Corporation gives Licensee permission to print a reasonable number of copies of Other Documentation for Licensee’s 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.
2
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 CORPORATION’S 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 Corporation’s 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 Corporation’s 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
3
4
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
5
Contents
6
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 User’s 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
7
TANK Installation Guide
8
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
9
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:
[email protected]
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:
[email protected]
Knowledge-Based Articles/Tutorials (US & Canada only):
http://crmweb.intergraph.com/ecustomer_enu
Send documentation comments or suggestions to
[email protected].
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
[email protected] 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)
5
3
2010 (v11)
6
2
2008 (v10)
7
1
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="""
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="""
For silent installation with SPLM, type: Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="SPLM" SERIALNUMBER="""
For silent installation with customized path, type: Setup.exe /v"/qb INSTALL_SILENT="Yes" LANG="Eng" ESL_COLOR="SPLM" SERIALNUMBER="" INSTALLDIR=\"""
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
