Support _ FAQs & Tutorials by Topic _ ETAP

Resolution of problems related to installation of ETAP

Activation Code and License Types

Type of ETAP Security Keys

ETAP License Manager

Error Messages and Exceptions

General

Activation Code and License Types

Item 1: ERROR: "An invalid Activation Code was entered. Please retry!"Item 2: Stand Alone vs. Network configurationItem 3: Function of Reset License Manager ToolItem 4: LAN Vs WAN Network LicenseItem 5: What files compose an ETAP project?Item 6: How to determine who is using ETAP

Item 1:ERROR: An invalid Activation Code was entered. Please retry!

Error Message appears when an invalid activation code has been entered.

Verify that the Activation Code you entered is correct. Note that the activation code is casesensitive. Also, each release of ETAP has a unique activation code. This code can be foundon the DVD sleeve.

If you have received the activation code through e-mail, copy and paste this code into theETAP Activation Code editor to avoid any typos. Copying any extra characters or space willmake the code invalid.

If the error message continues to be displayed, e-mail a screen capture of the ActivationCode editor showing the activation code you have entered to support.etap.com. We willverify the activation code for you.

Item 2:Stand Alone vs. Network configuration

Stand Alone: In this configuration, the ETAP License Manager, the security key and ETAP reside on the same machine.

Network Configuration: In this configuration, the ETAP License Manager and key reside on the server (ETAP can also reside on the server). The ETAP License Managerserver is responsible for providing access to ETAP clients allowing them to run ETAP.

Item 3:Function of Reset License Manager Tool

In ETAP 7.0.0, the Reset License Manager option serves as a tool to:

Automatically change from one security key model to anotherTo clear all ETAP clients connected to the ETAP LM server

In a stand-alone configuration, selecting the option to Reset the License Manager will stop and start the ETAP License Manager Service within the machine. This will causeETAP to close.

In a Network configuration, selecting the option to Reset the License Manager in the ETAP LM server will stop and start the ETAP LM Service in the server. This will causeall clients connected to the ETAP server to lose access with ETAP. As a result, ETAP will close. In a network configuration, selecting to Reset License Manager from a clientmachine will not have any effect on that machine, other client machines or the ETAP server. This is due to the fact that the actual ETAP LM service is being provided by the

Support | FAQs & Tutorials by Topic | ETAP http://etap.com/support/faqs-tutorials-installation-problems.htm

1 of 16 6/10/2013 2:44 PM

server (machine in which the security key is connected) andnot the client. The Reset License Manager option was originallyincluded in ETAP 6.0.0 as the Setup Maintenance option. Thisfunction was intended to make it easier for users to changethe security key from one model to another since the programautomatically configures the License Manager for the selectedkey.

Item 4:LAN Vs WAN Network License

ETAP distinguishes if a network license key is used in a LAN orWAN network. If the network is WAN, users who are licensedfor and have an ETAP activation code for a LAN will not be ableto run ETAP and the ETAP License Wizard will generate the

following message:

To determine whether a LAN or WAN license is installed, ETAPlooks at the IP addresses of both the server and the localcomputer. The rules that ETAP uses are outlined here:

If the server name is ., LocalHost, or the local computername, it is a LAN.

If the server name is anything else, translate the server name to its IP address and follow the rules below.

Rules:If the IP address is one of the following and in the indicatedrange, it is a LAN:

If the IP address does not fall into the above ranges, it is aroutable IP address and therefore a WAN license is required.

If the user has a WAN IP address and they are licensed forLAN use, they must either upgrade the license to a WAN orinstall the software and the ETAP License Manager on a PCwith a LAN IP address.

Contact ETAP Sales at [email protected] for pricing to upgradeto a WAN.

Item 5:What files compose an ETAP project?

An ETAP project consists of the following files, these files must have the same filename:

.mdb

.oti

.pso (This file exists if you have OLE objects in your projects)

.cpx (This file exists if you have cable pulling projects)

.grd (This file exists if you have ground grid systems)

Item 6:How to determine who is using ETAP

Determining who is using an ETAP License can be done by opening ETAP, going to Help\About ETAP and clicking on the License Tab of the ETAP Enterprise Editor. Ascreen like the one to the left will appear, providing such information.


2 of 16 6/10/2013 2:44 PM

Type of ETAP Security KeysItem 7: Types of ETAP security keys and Operation System compatibilityItem 8: Aladdin HASP USB-1600 key is not detected

Item 7:Types of ETAP security keys and Operation System compatibility

Types of ETAP security keys

Aladdin HASPUSB - ETAP-OTI 1600

Dallas 1-WireUSB ETAP-OTI 1410 Parallel Port

Table that depicts compatibility of ETAP keys with different operating systems

OPERATING SYSTEM 32-bit 64-bit

Microsoft Windows 7

(Professional, Ultimate)

Hasp USB (green)

1-Wire ParallelHasp USB (green)

Windows Vista (SP1)

(Home Premium, Business, Enterprise)

Hasp USB (green)

1-Wire USB (blue)

1-Wire Parallel

Hasp USB (green)

Microsoft Windows XP (SP 3)

(Professional or Home Edition)

Hasp USB (green)

1-Wire USB (blue)

1-Wire Parallel

Hasp USB (green)


3 of 16 6/10/2013 2:44 PM

Microsoft Server 2008 (SP2)

Hasp USB (green)

1-Wire USB (blue)

1-Wire Parallel

Hasp USB (green)

Microsoft Server 2003 R2 (SP 2)

Hasp USB (green)

1-Wire USB (blue)

1-Wire Parallel

Hasp USB (green)

Microsoft Server 2003 (SP 2)

Hasp USB (green)

1-Wire USB (blue)

1-Wire Parallel

Hasp USB (green)

Note:Microsoft Windows 7 only supports the Aladdin HASP and Parallel security keys.64-bit Operating Systems only support the Aladdin HASP key. All other security keys are not compatible.

For key replacement information, please contact the ETAP sales department at [email protected] and provide the following information:

Your NameCompany NameETAP Serial NumberInformation on the sticker of your existing keyShipping AddressContact information

Item 8:Aladdin HASP USB-1600 key is not detected

If ETAP failed to detect the USB 1600 (Green) key, go to the Device Manager (Start menu\ Control Panel \ System | Hardware \ Device Manager) and check if the key isdisplayed as shown on Figure 1.

Figure 1If there is a HASP HL 3.21 device entry with a yellow exclamation mark under Other devices section as shown on Figure 1, it indicates an installation problem with the key.

For proper installation of the key, please proceed with the following steps:

(1) Go to the Windows start button and open the Run window (leave this window open).

(2) Go to C:\Program Files\Operation Technology Inc\ETAP License Manager XXX folder and locate the executable file named haspdinst.exe. where XXX represents thelatest version number of ETAP being used. Drag and drop this file into Run Window as shown in Figure 2.


4 of 16 6/10/2013 2:44 PM

Figure 2

Once you have dropped this file into the Run windows, anentry will appear, and at the end of the entry enter a spacefollowed by install

The complete entry should read (as shown in Figure 3):"C:\Program Files\Operation Technology Inc\ETAP LicenseManager XXX\haspdinst.exe" install


5 of 16 6/10/2013 2:44 PM

Figure 3After clicking on the OK button, the message shown in Figure 4should appear.

Figure 4You will be notified that the installation of the driver for the key was successful by the message shown in Figure 5.

Figure 5After clicking OK, you will begin to see the messages shown in Figure 6 and Figure 7.Please note that if these messages do not appear, please disconnect the USB keyand re-connect it once again.

Figure 6

Figure 7If the drivers were properly installed, in the Device Manager you will see that the HASP HL 3.21device entry is no longer listed with a yellow exclamation mark under Other devices section asshown on Figure 1. Instead, you will see that the Aladdin USB key is listed under Universal SerialBus Controllers section as shown in Figure 8.


6 of 16 6/10/2013 2:44 PM

Figure 8


7 of 16 6/10/2013 2:44 PM

ETAP License Manager

Item 9: ERROR: ETAP failed to receive authorization from the ETAP License ManagerItem 10: Latest ETAP License Manager compatibility with previous versions of ETAPItem 11: ERROR 1603 Fatal error during installation appears during the installation of ETAP License Manager 7.1.0.Item 12: Cannot uninstall previous versions of ETAP License ManagerItem 13: Verifying if the latest version of the ETAP License Manager is correctly installed

Item 9:ERROR: ETAP failed to receive authorization from the ETAP License Manager

Make sure that you have installed the latest version of License Manager. The latest ETAP License Manager is provided in the DVD containing the latest version of ETAP.

Go to the server and from Services, verify that the License Manager (ETAP Lic Mgr) service is started (Control Panel \Administrative Tools \ Services). Alternatively, youcan go to windows.

If the service starts but the client machine fails to receive authorization, check the License Manager computer to ensure that the Windows' firewall is not blockingincoming traffic. To do this, go to the computer on which you have the license manager installed and select "Run/Control Panel/Windows Firewall". On the General page,note whether the Firewall is on or off. If it is on, go to the exceptions page and see if the License Manager is listed and checked. If not, you should select the Add Port...button. Enter Etap License Manager for Name: and enter 6260 as the Port Number: Ensure that TCP is selected. Also check the check box that requests a notification if aprogram is blocked and click ok, continue clicking OK on previous pages until you return to the control panel. If your IT department controls the Windows Firewall, you mayhave to coordinate with them to get the port open on the computer running the License Manager software.

Go to your client computer and select "Run/Control Panel/Windows Firewall". If it is on, go to the exceptions page and check the check box that requests a notification if aprogram is blocked and click ok, continue clicking OK on previous pages until you return to the control panel.

If the service does not start, go to the Event Viewer Application Logs and view the ETAP License manager Application log for clues regarding why the service does notstart. Every attempt to start the service generates several entries. Review all logs.

If the problem is caused by failure of the application to find the key, then verify that the key is installed properly.

For Dallas 1-Wire USB Key ETAP-OTI 1410

For verification of the proper installation of the USB key ETAP-OTI 1410, go to the Control Panel \ System \ Hardware\Device Manager. If the1-Wire Devices is shown in the DeviceManager, then the key is installed properly.

For USB Aladdin HASP Key ETAP-OTI 1600

For verification of the proper installation of the USB key ETAP-OTI 1600, go to the Control Panel \ System \ Hardware\ Device Manager and you should see Aladdindrivers under the Universal Serial Bus Controllers.


8 of 16 6/10/2013 2:44 PM

Item 10:Latest ETAP License Manager compatibility with previous versions of ETAP

The latest ETAP License Manager is compatible with previous versions of ETAP. To be able to use the latest version of ETAP, you need to use the latest or a newer versionof the ETAP License Manager.

Item 11:ERROR 1603 Fatal error during installation appears during the installation of ETAP License Manager 7.1.0.

In some cases, the HASP drivers installed from previous installation cannot be removed.

The un-installation process is then aborted with a 1603 Fatal Error message.


9 of 16 6/10/2013 2:44 PM

The previous drivers may be removed manually with the following steps:(1) Go to C:\Program Files\Operation Technology Inc\ETAP LicenseManager 700(2) In this folder, look for the Hasp program file named Haspdinst.exe(3) Right click on this file and create a shortcut(4) Go to shortcut Properties and edit the shortcut Target "C:\ProgramFiles\Operation Technology Inc\ETAP License Manager700\Haspdinst.exe" -r -fr(5) Run this short cut to remove Hasp drivers(6) Install ETAP 7.1.0 License Manager

Item 12:Cannot uninstall previous versions of ETAP License Manager

Cannot uninstall previous versions of ETAP License Manager

If uninstalling previous versions of the ETAP License Manager is not possible through the Control Panel feature (take for example the case when uninstalling ETAP 6.0.0after ETAP 7.0.0 has already been installed), please proceed with the following procedure:

Insert the ETAP CD of the version you want to uninstall (in this case ETAP 6.0.0 CD), browse to the CD folder and launch the file called setup.exe.

A window shown in the image below will appear. Select the Modify Option and click on Next.

The uninstall process will proceed with the following window.Please uncheck ETAP License Manager and click Next (This willuninstall ETAP License Manager 6.0.0.).

If you want to completely uninstall all the applications relatedto ETAP (in this case ETAP 6.0.0), please uncheck all. Note thatany unchecked items will be uninstalled.


10 of 16 6/10/2013 2:44 PM

Item 13:Verifying if the latest version of the ETAP License Manager is correctly installed

To verify if the Latest version of the ETAP License Manager is correctly installed, please do the following:

Go to Control Panel and in the Add/Remove programs section, verify that the latest License Manager is listed as shown in the following image. If it is not listed, pleaseinstall the latest version of the License Manager. If it is listed, proceed to the next step.

Go to Windows Start Button and type in services.msc

A window with a list of services will appear. Please verify that an EtapsLic Mgr service appears on the list of services. If it appears, select theEtaps Lic Mgr service. Right click and in the list of options that appear,select Properties.


11 of 16 6/10/2013 2:44 PM

In the Etaps Lic Mgr Properties window, verify that the path toexecutable is pointing to the latest version of the LicenseManager. The full path should read: C:\ProgramFiles\Operation Technology Inc\ETAP License ManagerXXX\Etapslmt.exe where XXX represents the version number ofthe latest License Manager (in this case its 710).

Error Messages and Exceptions

Item 14: Selecting the Nameplate tab causes an exception and ETAP shuts down


12 of 16 6/10/2013 2:44 PM

Item 15: ERROR: UFL u2lstrng that implements the function is missingItem 16: Exception occurs when launching ETAPItem 17: ERROR: ETAP failed to continue the license from LM due to time zone discrepancyItem 18: ERROR: ETAP project file name and path is limited to 128 charactersItem 19: ERROR: The Project file you are trying to open is marked as Read-Only. ETAP cannot open this file!Item 20: ERROR: The parameter is incorrectItem 21: ERROR: Could not find file (unknown). Drivers SQLSetConnectAttr failedItem 22: ERROR: ETAP key is not found or the License Manager is not ready! message appearsItem 23: ERROR: Could not read key! message appears when using ETAP 556 with Aladdin HASP USB-1600 Stand Alone key

Item 14:Selecting the Nameplate tab causes an exception and ETAP shuts down

Completely close ETAP. Run the REG.BAT file in ETAP XXX\pvdt40 folder, where XXX represents the latest version of ETAP.

If the issue does not get resolved, go to Control Panel\Add or Remove Programs, locate the latest version of the ETAP program, click on Change and then select Repair.

Item 15:ERROR: UFL u2lstrng that implements the function is missing

When opening certain ETAP reports, the following error appears: UFL u2lstrng that implements the function is missing and the selected report will not open.

This error message shows that installation of Crystal Reports, which is the software used for generating ETAP reports has been overridden by other installations. Toresolve the issue, do the following:

(1) Copy the u2lstrng.dll and u2lsqrt.dll files from the ETAP program directory (C:\ETAP...) to the C:\Program Files\Common Files\Business Objects\3.0\bin directory(2) If the above solution does not correct the problem, go to the Control Panel \ Add or Remove Programs select Change and Repair ETAP.(3) If Repair does not correct the problem then uninstall ETAP and re-install it again.

Item 16:Exception occurs when launching ETAP

An exception occurs and a general error message shown below appears when launching ETAP.

This is a general error message and it can be due to a number ofreasons.

User does not have Read, Write and Execute permissions to theETAP application folder and other project folder(s). This issue can beresolved by providing these permissions or by moving the project filesto a location in which user has these permissions.

If the problem does not get resolved, try the following:

(1) Run Mdac_typ.exe file from the ETAP XXX\Other folder (Where XXX, represents the latest version number of ETAP)(2) Run Jet40SP3_Comp.exe file from the ETAP XXX\Other folder(3) Restart computer(4) Run ETAP

The error can also be project dependent. This can be determined by opening other projects. If other projects are successfully opened except one, the problem might belimited to that specific project. Please contact support.etap.com


13 of 16 6/10/2013 2:44 PM

Item 17:ERROR: ETAP failed to continue the license from LM due to time zone discrepancy

This error message occurs when the clock on your machine (client)and the clock on the PC with the license manager (server) contain adifference of more than 5 minutes. To avoid this issue, the clocks onboth computers (client and server) should have the correct date andtime for time zone in which they reside.

If you believe the time and date is correct, please send us screencaptures of both computers date and time via e-mail. This can bedone by going to Control Panel and Selecting the Date and Timefeature.

Item 18:ERROR: ETAP project file name and path is limited to 128 characters

This error appears when the name and path of the project you are trying to open contains more than 128 characters.

The issue can be fixed by reducing the path length.

Please note that opening the project from the network itself can cause this problem. It is recommended to have the project file on your local drive at all times whenaccessing from ETAP.


14 of 16 6/10/2013 2:44 PM

Item 19:ERROR: The Project file you are trying to open is marked asRead-Only. ETAP cannot open this file!

Error appears when the project files are set to Read Only. Remove the Read Onlyattribute. This can be done by selecting all files related to the project. Right click,select Properties, and the Properties Editor will appear. Un-check the Read-onlyoption, click on Apply and then the OK button.

Item 21:ERROR: Could not find file '(unknown)'

User gets the following message when attempting to open an ETAP project: Could not find file (unknown).

Could not find file '(unknown)'.pdf


15 of 16 6/10/2013 2:44 PM

Item 22:ERROR: ETAP key is not found or the License Manager is not ready!

Answer:

Verify that the ETAP License Manager is installed in the designated computer. If it is not, Install the License Manager and make sure there is no firewallinterference. The default License Manager port is 6260.

The ETAP License Manager Service is not running. Reset the License Manager from Start\All programs\ETAP XXX\Reset License Manager.

ETAP key is not properly connected to the computer or key drivers are not installed properly. Verify that the key is securely attached to the computer. Refer tothe ETAP User Guide, Chapter 2 for details.

The ETAP License Manager is installed in a Virtual Machine. ETAP prevents the operation of the License Manager on a virtual machine. This is due to the nature ofvirtual machines that makes it possible to replicate the ETAP License Manager in violation of its intended number of users per ETAP License Grant and Agreement.


16 of 16 6/10/2013 2:44 PM

Support _ FAQs & Tutorials by Topic _ ETAP

Documents

server etap

etap server

etap license managerserver

etap clients

etap license manager

etap project

release of etap

network license key