I STALL

GUIDE

PREREQUISITES Platform Program

4.2 for ArcGIS

You must have the ArcGIS program installed on the computer on which you are installing LIDAR Analyst. Administrative Permission Confirm you have Administrative Privileges on the computer on which you will be installing LIDAR Analyst. If you do not have Administrative Privileges, contact your System Administrator to install the product for you or request that you have read/write permissions for the installation directory. The default installation direc- tory is: C:\Program Files\Visual Learning Systems\LIDAR Analyst 3D\ArcGIS. Uninstall Previous Version If you have a previous 4.x version of LIDAR Analyst installed on your computer, you must uninstall it before installing the new version. Also, some computer config- urations will not allow the installation of version 4.2 if you have a 3.x version installed. If this is the case, uninstall the 3.x version. Software Requirements LIDAR Analyst 4.2 for ArcGIS requires both Microsoft .NET Framework 1.1 and
2.0 in order to install successfully.

ie a Lear i iii Ssteieie , l i c. We put the Information in GIS

Copyright 2001-2007 Visual Learning Systems, Inc. All Rights Reserved. THE INFORMATION CONTAINED HEREIN IS PROPRIETARY TO VISUAL LEARNING SYSTEMS, INC. AND SHALL

NOT BE REPRODUCED, COPIED IN WHOLE OR IN PART, ADAPTED, MODIFIED, OR DISSEMINATED WITHOUT THE EXPRESS WRITTEN CONSENT OF VISUAL LEARNING SYSTEMS, INC. LIDAR Analyst is a registered trademark of Visual Learning Systems, Inc. We put the information in GIS is a service mark of Visual Learning Systems, Inc. ESRI and ArcMap are registered trademarks and ArcGIST and Spatial AnalystT are trademarks of Environmental Systems Research Institute, Inc.The names of other companies and products herein are trademarks or registered trademarks of their respective owners.

LIDAR Analyst Install Guide Verifying Microsoft .NET Framework Installation Before installing LIDAR Analyst 4.2, you must verify that Microsoft .NET Framework 1.1 and 2.0 are installed on your computer. 1 Click on the Start button and choose Control Panel on the Start menu. 2 Double-click on Add or Remove Programs in the Control Panel window. 3 Scroll down to find Microsoft.NET Framework in the list of programs.

4 If Microsoft .NET Framework 1.1 and 2.0 are in the list, skip to Installation on page 3. -orIf Microsoft .NET Framework 1.1 and/or 2.0 are not in the list, proceed to the next steps, as necessary. Installing Microsoft .NET Framework 1.1 If you do not have the .NET Framework 1.1 installed on your computer, you can download it for free from the Microsoft web site. If you have .NET Framework 1.1 installed, skip to Installing Microsoft .NET Framework 2.0 . 1 Go to the Microsoft site http://www.microsoft.com/downloads and select .NET Framework Version 1.1 Redistributable Package . 2 Click on the Download button to install the Microsoft .NET Framework Ver- sion 1.1 Redistributable Package. 3 After the Microsoft .NET Framework 1.1 is installed, continue to 4 DV09192007-1

LIDAR Analyst Install Guide the next step. Installing Microsoft .NET Framework 2.0 If you do not have the .NET Framework 2.0 installed on your computer, you can download it for free from the Microsoft web site.

DV09192007-1 5

LIDAR Analyst Install Guide 1 Go to the Microsoft site http://www.microsoft.com/downloads and select .NET Framework Version 2.0 Redistributable Package (x86) . 2 Click on the Download button to install the Microsoft .NET Framework Ver- sion 2.0 Redistributable Package (x86).

INSTALLATION
REMEMBER: If you have a previous 4.x ver- sion of LIDAR Analyst installed on your com- puter, you must uninstall it before proceeding. You are now ready to download, if necessary, and install the LIDAR Analyst 4.2 software. Installing LIDAR Analyst 4.2 1 Browse to the location where you saved the LIDAR Analyst program down- loaded from the Visual Learning Systems web site and unzip the files. -orLaunch your Visual Learning Systems Product CD. 2 Double-click on the setup.exe application. to run the install

In most instances, LIDAR Analyst will prompt you to install the Visual C++ Runtime Libraries.

3 Choose Install.

DV09192007-1 6

The LIDAR Analyst for ArcGIS Setup Wizard Welcome dialog box opens.

4 Choose Next. The LIDAR Analyst for ArcGIS License Agreement dialog box opens.

5 Read the Software License Agreement and if acceptable, select I Agree and choose Next.

The LIDAR Analyst for ArcGIS Select Installation Folder dialog box opens.

6 Accept the default installation folder (C:\Program Files\Visual Learning Sys ).

tems\Lidar Analyst3D\ArcGIS\

-orChoose Browse to select a different folder location. 7 Choose Next. The LIDAR Analyst for ArcGIS Confirm Installation dialog box opens.

8 Choose Next.

The installation begins.

When the installation is finished, the Installation Complete dialog box oepns.

9 Choose Close.

SOFTWARE ACTIVATION
With LIDAR Analyst installed, you can activate it as an extension of ArcMap. Activation allows you to access the LIDAR Analyst toolbars and functions within the ArcMap workspace. Activating LIDAR Analyst You must activate the LIDAR Analyst software before you can run the Tutorial or submit a license request. 1 Open ArcMap. 2 Choose the ArcMap Tools menu, and then choose Extensions.

The ArcMap Extensions dialog box opens, displaying a list of registered extensions available for your version of ArcGIS.

3 If LIDAR Analyst 4.2 is not in the list, choose Close and see Verify the Microsoft .NET Framework 1.1 Installation on page 27. -orSelect LIDAR Analyst 4.2, and then choose Close. 4 Choose the ArcMap View menu, and then choose Toolbars.

5 Choose LIDAR Analyst 4.2 Toolbar and LIDAR Analyst Building Edit Tool- bar on the toolbar submenu. The LIDAR Analyst Toolbars display in the ArcMap workspace.

LIDAR Analyst 4.2 is now activated. You can dock the toolbar(s) on the ArcMap toolbar.

6 You can now run the LIDAR Analyst 4.2 Tutorial. -orIf you purchased the LIDAR Analyst 4.2 software, continue to the next step to submit a license request.

LICENSE REQUEST
NOTE: If you will be running the LIDAR Ana- lyst Tutorial only, you do not need a license. Once your LIDAR Analyst software is installed and activated, you can submit a license request to Visual Learning Systems, Inc. (VLS). VLS will return the licensing file to you via email, usually within one business day. Submitting a License Request 1 On the LIDAR Analyst menu choose Licensing, and then choose License Manager.

The LIDAR Analyst License Manager dialog box opens.

2 Choose Submit License Request.

The Submit License Request dialog box opens. Certain fields may display information from your operating system.

3 In the Extensions field, select LIDAR Analyst. 4 Enter information, as necessary, in the Name, Company, and From Email Address fields. 5 Select either Evaluation or Purchased in the License Type field.

6 Choose Submit. A message box opens indicating your email was sent successfully. If your system prevents you from sending the License Request form, you can send the requested information via email to licensing@vlsinc.com. Enter LIDAR Analyst License Request in the subject field and include your name, company, and license type in the body of your email. VLS returns a licensing file to you via email, usually within one business day.

LICENSE AUTHORIZATION
NOTE: If you purchased a software dongle for a stand-alone license, skip to Dongle Usage and Installation on page 17. NOTE: To set up a float- ing license, skip to Set- ting Up a Floating License on page 13.

Authorizing Your License Once you receive the license file from VLS, you can authorize your license. After your license is authorized, you will have full access to all the features of the LIDAR Analyst software. A LIDAR Analyst license is set up for either stand- alone use or floating use. Setting Up a Stand-Alone License After receipt of your LIDAR Analyst license file from VLS, proceed with the fol- lowing steps to set up a stand-alone license. 1 Create a folder (C:\VLS_Licenses, for example) for your VLS license(s) on your C:drive. 2 Save the license file (extension .lic) to the VLS Licenses folder. 3 On the LIDAR Analyst menu choose Licensing, and then choose License Manager.

The LIDAR Analyst License Manager dialog box opens.

4 Choose Location.

The Set License Location dialog box opens.

5 Select Stand Alone License. 6 Choose the ellipsis field. button to the right of the License Path

The Please select a license file dialog box opens

7 Browse to where you saved the license file, select the license file, and then choose Open. The license file displays in the License Path field on the Set License Location dialog box.

8 Choose OK.

The Set License Location dialog box closes. The License information displays in the Host ID and License Location fields on the LIDAR Analyst License Manager dialog box.

9 Expand the Authorized Extensions layer in the Extensions list box and select LIDAR Analyst3D to review License Information. Corresponding license information displays in the License Information list box.

10 Choose Close. You are now ready to start extracting features from your imagery using LIDAR Analyst. Setting Up a Floating License NOTE: A LIDAR Analyst License Server is required for using float- ing licenses. Contact your system administra- tor if you have questions regarding setup. After receipt of your LIDAR Analyst license file from VLS, proceed with the fol- lowing steps to setup and access your floating license.

1 On the LIDAR Analyst menu choose Licensing, and then choose License Manager.

The LIDAR Analyst License Manager dialog box opens.

2 Choose Location. The Set License Location dialog box opens.

3 Select Floating License. 4 In the License Server field, enter the <IP Address> or <Host Name> of your license server where the license file is saved. 5 Choose OK. The Set License Location dialog box closes.

The License information displays in the Host ID and License Location fields on the LIDAR Analyst License Manager dialog box.

The Floating License button appears at the bottom left side of the LIDAR Analyst License Manager dialog box. 6 Expand the Authorized Extensions layer in the Extensions list box and select LIDAR Analyst3D to review License Information. Corresponding license information displays in the License Information list box.

7 Choose Floating License. The LIDAR Analyst License Manager dialog box expands to display the float- ing license options.

NOTE: You do not need to manually check out a license each time you want to use LIDAR Analyst. LIDAR Analyst automatically checks out a license (if one is available) when you open ArcMap, and then checks it back in when you exit the application.

8 With LIDAR Analyst selected in the Extensions list box, choose from the available floating-license options according to the following:
OPTION Check-Out License FUNCTION Choose this option to check out a floating license. The license remains checked out until you return it to the License Manager using the Check-In License option. Choose Check-In License to return your checked- out license to the License Manager. If your server has multiple license-authorization levels of LIDAR Analyst, choose Preferred Level to select the license level you want to run when you log in. The default is Standard. Borrow License If your server has licenses you can borrow, choose Borrow License to check out a temporary license for use in a remote unit. The maximum time for check out is 6 days. After 6 days the license automatically returns to the License Manager. When you choose Borrow License, the Borrow License dialog box opens, allowing you to set a return date for the license.

Check-In License Preferred Level

Return License

To return a borrowed license before the expiration date.

When you select a license option, LIDAR Analyst automatically processes your selection and displays corresponding license information in the License Information list box.

Choose Close. You are now ready to use LIDAR Analyst.

DONGLE USAGE AND INSTALLATION

NOTE: The dongle does not work on a computer with a 64bit system. Visual Learning Systems provides the ability to run the software with a Macrovi- sion FLEXidT hardware dongle. A dongle, also referred to as a serialized hard- ware key or hardware token, is a small hardware device that plugs into a USB slot on your computer to authenticate the software. A dongle is used to limit software access to whomever has the dongle attached to their system via the associated license file. The software will run only when the dongle is plugged in. VLS Dongle usage is based on a stand-alone type license. This usage enables flex- ibility for accessing the software from more than one computer. You can move the license at any time by installing the dongle drivers on another computer and mov- ing the USB dongle to the new computer. This license allows the VLS applica- tions to be installed on any number of computers, but limits concurrent usage to the number of license dongles purchased. Every dongle has a unique identification number. The number is printed both on the dongle and on the anti-static bag the dongle comes packaged in.

NOTE: One FLEXid dongle can authenti- cate two or more VLS products.

The ID on your FLEXid dongle begins with FLEXID=9-. Your VLS product license is locked to your FLEXid dongle. IMPORTANT: If your dongle is damaged, you can return it to VLS for replacement. However, VLS does not replace lost dongles. Prerequisites NOTE: You must install the dongle device driv- ers before you can authorize your VLS soft- ware License. Dongle Device Drivers To set up your license and run the Visual Learning System software with the don- gle you need to first install the system device drivers to enable the software and hardware to work together. The dongle device drivers are provided on the Visual Learning System Product CD in the FLEXid Dongle Installer folder. The drivers must be installed on your computer for the licensing to work. The two required drivers are the: Hasp HL

FLEXid-9

You will need to install the dongle device drivers on each computer you will use the dongle.

Administrative Permission Confirm you have Administrative Privileges on the computer on which you will be installing the drivers. If you do not have Administrative Privileges, contact your System Administrator to install the drivers for you or request that you have read/write permissions for the installation directory. Uninstall Other FLEXid Drivers Under certain circumstances you may need to remove other version FLEXid driv- ers. Use the FLEXid Cleanup Utility provided in the FLEXid Dongle Installer folder to remove an older installation of the FLEXid drivers. Remove Other Dongles Remove all dongles attached to your computer and close all open applications. Installation Plug in the Dongle Plug the FLEXid dongle into an available USB port on your computer. A Found New Hardware system message may display. If you are running Microsoft Windows XP, a system Hardware Installation message may display indicating that the Aladdin USB Key software is not verified. If you choose Continue Anyway, the software associated with the dongle installs and a system message displays, indicating that the new hardware is installed and ready to use. You are now ready to install the two drivers necessary for using the dongle. NOTE: Before starting the driver install pro- cess, close any programs that access the HASP HL Diver. Install the HASP HL Driver 1 Launch your Visual Learning System Product CD and open the FLEXid Don- gle Installer folder. 2 Double-click on the HASP_Installer.exe run the install application. to

The HASP HL Device Driver Installation Welcome dialog box opens.

3 Choose Next. The End User License Agreement dialog box opens.

4 Read the License Agreement and if acceptable, select the I accept the license agreement option. 5 Choose Install. The installation begins.

Upon installation, a success message displays.

6 Choose Finish. Install the FLEXid-9 Drivers 1 Double-click on the FLEXid_Installer.exe FLEXid Dongle Installer folder on your Visual Learning System Product CD to run the install application. The FLEXId Dongle Driver Install Wizard Welcome dialog opens. in the

2 Choose Next.

The Select Options dialog opens.

The installation gives you the option to install drivers for different dongle versions. 3 Clear the FLEXid 6_7 Drivers and FLEXid 8 DRIVERS options. NOTE: This version of FLEXid corresponds to the first digit of the dongle serial number (9) printed on the side of the dongle. 4 Select only the FLEXid 9 Drivers option and choose Next. The Start Copying Files dialog box opens.

5 Confirm that only FLEXid 9 Drivers displays, and then choose Next.

A progress bar displays the progress of the installation.

The FLEXid 9 Drivers install and the Wizard Complete dialog box opens.

NOTE: Restarting your computer is required to complete the installa- tion.

6 Confirm Yes is selected to restart your computer, and then choose Finish. Your computer restarts. The FLEXid driver is now fully installed and operational, and your FLEXid dongle will be recognized when connected to your computer. Verify the Dongle You can verify that the FLEXid dongle is attached and working properly by using the VLSHostID.exe file. 1 With your dongle plugged in, double-click on the VLSHostID.exe

in the FLEXid Dongle Installer folder on your Visual Learn- ing System Product CD to execute the test application.

The VLS Host ID box opens, displaying the Host IDs detected on your computer.

FLEXID=9-XXXXXXXX NOTE: You may need to remove other versions of the FLEXid drivers if the FLEXid-9 drivers installation is not suc- cessful, see Remove Previous Version FLEXid Dongle Drivers on page 28. If the drivers and dongle are working properly, the VLS Host ID appears, followed by your dongle identification number, in the VLS Host ID display. The correct operation of the USB dongle results in a Host ID that ends with FLEXID=9- followed by eight alphanumeric characters. The eight characters correspond to the Host ID recorded on the side of the dongle and on the anti- static packet that the USB dongle came in. The Host ID also appears in the license files provided to you on the Visual Learning System Product CD. Authorizing Your License Once your FLEXid drivers are installed and recognized, you can authorize your license. After your license is authorized, you will have full access to all the fea- tures of the LIDAR Analyst software. Setting Up the Dongle Stand-Alone License 1 Save the VLS Dongle FLEXid license file (extension .lic) to the Visual Learn- ing Systems install folder or other preferred location on your computer. The default installation directory is: C:\Program Files\Visual Learning Systems\LIDAR Analyst 3D\ArcGIS. 2 On the LIDAR Analyst menu choose Licensing, and then choose License Manager.

The LIDAR Analyst License Manager dialog box opens.

3 Choose Location. The Set License Location dialog box opens.

4 Select Stand Alone License.

5 Choose the ellipsis

button to the right of the License Path field.

The Please select a license file dialog box opens

6 Browse to where you saved the license file, select the license file, and then choose Open. The license file displays in the License Path field on the Set License Location dialog box.

7 Choose OK. The Set License Location dialog box closes.

The License information displays in the Host ID and License Location fields on the LIDAR Analyst License Manager dialog box.

8 Expand the Authorized Extensions layer in the Extensions list box and select LIDAR Analyst3D to review License Information. Corresponding license information displays in the License Information list box.

9 Choose Close. You are now ready to use LIDAR Analyst.

TROUBLESHOOTING
LIDAR Analyst 4.2 does not appear in the Extensions dialog box Verify the Microsoft .NET Framework 1.1 Installation NOTE: If necessary, follow the instruction under Verifying Microsoft .NET Framework Instal- lation on page 2 to check to see if you have Microsoft .NET Frame- work 1.1 installed. 1 Verify that Microsoft .NET Framework 1.1 is installed on your computer. 2 If Microsoft .NET Framework 1.1 is installed on your computer, skip to Con- firm ArcGIS ArcObjects .NET API Installation on page 27. -orIf you do not have Microsoft .NET Framework 1.1 installed on your com- puter, continue to the next step. Install Microsoft .NET Framework 1.1 1 Go to the Microsoft site http://www.microsoft.com/downloads and select .NET Framework Version 1.1 Redistributable Package . 2 Click on the Download button to install the Microsoft .NET Framework Ver- sion 1.1 Redistributable Package. 3 After the Microsoft .NET Framework 1.1 is installed, continue to the next step. Confirm ArcGIS ArcObjects .NET API Installation You need to update ArcGIS ArcObjects.NET API so that the LIDAR Analyst extension becomes available in the ArcMap list of extensions. 1 Exit ArcMap. 2 Click on the Start button and choose Control Panel on the Start menu. 3 Double-click on Add or Remove Programs in the Control Panel window. 4 Scroll down to find ArcGIS Desktop in the list of programs. 5 Select ArcGIS Desktop and choose Change.

The ArcGIS Desktop Setup Wizard opens.

NOTE: You may need to insert your ArcGIS Desktop install CD.

6 Under Application Maintenance, select Modify, and then choose Next.

7 In the list box under Select Features, locate .NET Support.

NOTE: For VLS Technical Support, call toll free (866) 968-7857, extension 291.

8 If a hard-drive icon displays to the left of .NET Support, the ArcOb- jects.NET API is already installed. Contact VLS Technical Support for assis- tance. -orIf a red X icon displays to the left of .NET Support, the ArcObjects.NET API is not installed and you need to proceed to the next step. 9 Click on the red X icon next to .NET Support and select Will be installed on the local hard drive.

10 Next.

Choose

11 Under Ready to Modify the Application, choose Next. 12 Under Successfully installed, choose Finish. LIDAR Analyst 4.2 should now display in the list on the ArcMap Extension dialog box. Follow the steps in Activating LIDAR Analyst on page 7 to activate the LIDAR Analyst extension and add the toolbar. FLEXid=9-XXXXXXXX does not display in the VLS Host ID box Remove Previous Version FLEXid Dongle Drivers If the FLEXid number, in the format FLEXID=9-XXXXXXXX, is not included in the VLS Host ID display, you may need to run the clean-up utility to remove any previous version FLEXid drivers. 1 Remove the FLEXid dongle from your machine. 1 Open the Utility sub-folder in the FLEXid Dongle Installer folder on your

Visual Learning System Product CD.

2 Double-click on the FLEXidCleanUtility.exe

The FLEXid Cleanup Utility Wizard opens.

3 Choose Next. The installation begins. When the Cleanup Utility is installed, the Install Complete Wizard opens.

4 Choose Finish. 5 Restart your computer. 6 Return to Install the FLEXid-9 Drivers on page 20 to run the FLEXid driver installer again.