Docstoc

FME Installation and Licensing Manual

Document Sample
FME Installation and Licensing Manual Powered By Docstoc
					FME® Installation and Licensing Manual

E-mail: info@safe.com • Web: www.safe.com

Safe Software Inc. makes no warranty either expressed or implied, including, but not limited to, any implied warranties of merchantability or fitness for a particular purpose regarding these materials, and makes such materials available solely on an “as-is” basis. In no event shall Safe Software Inc. be liable to anyone for special, collateral, incidental, or consequential damages in connection with or arising out of purchase or use of these materials. The sole and exclusive liability of Safe Software Inc., regardless of the form or action, shall not exceed the purchase price of the materials described herein. This manual describes the functionality and use of the software at the time of publication. The software described herein, and the descriptions themselves, are subject to change without notice.

Copyright
© 1994 – 2009 Safe Software Inc. All rights are reserved.

Revisions
Every effort has been made to ensure the accuracy of this document. Safe Software Inc. regrets any errors and omissions that may occur and would appreciate being informed of any errors found. Safe Software Inc. will correct any such errors and omissions in a subsequent version, as feasible. Please contact us at: Safe Software Inc. Suite 2017, 7445 – 132nd Street Surrey, BC Canada V3W 1J8 www.safe.com

Safe Software Inc. assumes no responsibility for any errors in this document or their consequences, and reserves the right to make improvements and changes to this document without notice.

Trademarks
FME is a registered trademark of Safe Software Inc. All brands and their product names mentioned herein may be trademarks or registered trademarks of their respective holders and should be noted as such.

Document Information
Document Name: Version: Updated: FME Installation and Licensing Manual FME 2010 December 2009

Contents
Chapter 1 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1 If You Are Installing FME Server . . . . . . . . . . . . . . . . . . 1.2 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3 Windows System Requirements . . . . . . . . . . . . . . . . . . 1.4 Linux and UNIX System Requirements . . . . . . . . . . . . . 1.5 Determining the FME License Type to Install . . . . . . . . . 1.5.1 Fixed (Node-Locked) License . . . . . . . . . . . . . . . 1.5.2 Hardware-Locked License . . . . . . . . . . . . . . . . . 1.5.3 Floating License . . . . . . . . . . . . . . . . . . . . . . . . 1.6 FME Community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.1 FME User Central . . . . . . . . . . . . . . . . . . . . . . . Installing FME Desktop on Microsoft Windows . . . . . . . . . . 2.1 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1 Updating to a Newer FME Version . . . . . . . . . . . . Installing Fixed (Node-Locked) Licenses on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1 Requesting a Fixed (Node-Locked) License . . . . . . . . . . 3.2 Installing a Fixed (Node-Locked) License . . . . . . . . . . . . Installing Hardware-Locked Licenses on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1 Installing a Hardware-Locked License . . . . . . . . . . . . . . 4.1.1 Request a License . . . . . . . . . . . . . . . . . . . . . . . 4.1.2 Start the FME Licensing Wizard . . . . . . . . . . . . . Installing Floating Licenses on Microsoft Windows . . . . . . . 5.1 Installing a Floating License . . . . . . . . . . . . . . . . . . . . . 5.1.1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . 5.1.2 Download and Run the Installer . . . . . . . . . . . . . 5.1.3 Request and Install the License . . . . . . . . . . . . . 5.1.4 Install FME on Client Computers . . . . . . . . . . . . . 5.1.5 Start FME Registration . . . . . . . . . . . . . . . . . . . 5.2 Configuring the Floating License to Use a Specific Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3 Installing a Permanent Three-Server Redundant Floating License Server . . . . . . . . . . . . . . . . . . . . . . . . 5.3.1 Download and Run the Installer . . . . . . . . . . . . . 5.3.2 Start the License Servers . . . . . . . . . . . . . . . . . 5.3.3 Install FME on Client Computers . . . . . . . . . . . . . Installing FME on Linux and UNIX . . . . . . . . . . . . . . . . . . . . Installing Fixed (Node-Locked) Licenses on Linux and UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1 Installing a Node-Locked License . . . . . . . . . . . . . . . . . 7.1.1 Updating the FME Version . . . . . . . . . . . . . . . . . 1 1 1 1 2 2 2 2 3 3 3 5 5 5 7 7 8 11 11 11 11 13 13 13 13 14 15 15 16 16 17 17 18 19 21 21 22

Chapter 2

Chapter 3

Chapter 4

Chapter 5

Chapter 6 Chapter 7

Safe Software Inc.

iii

Contents

Chapter 8

Installing Floating Licenses on Linux and UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.2 Locating the FLEXlm License Server Files . . . . . . . . . . . . 8.3 Preparing for a New Floating License . . . . . . . . . . . . . . . 8.3.1 Creating a Directory for the FLEXlm License Server . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.2 Providing the Information to Generate a Floating License . . . . . . . . . . . . . . . . . . . . . . . . 8.4 Installing a New Floating License . . . . . . . . . . . . . . . . . . 8.5 Configuring FME to Use a Floating License . . . . . . . . . . . 8.6 Configuring a Floating License to Use a Specific Port . . . . 8.7 Starting FME from the Command Line . . . . . . . . . . . . . . Installing Grid Shift Files . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1 Installing Grid Shift Files on Microsoft Windows . . . . . . . . 9.2 Installing Grid Shift Files on Linux or UNIX . . . . . . . . . . . Using FME Desktop with Third-Party Applications . . . . . . . 10.1 FME Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.1 Reverting and Extending Applications . . . . . . . . . 10.1.2 Viewing Details and Options . . . . . . . . . . . . . . . .

23 23 23 24 24 24 25 26 26 27 29 29 30 31 31 31 32

Chapter 9

Chapter 10

iv

FME Installation and Licensing

1
Chapter 1

Getting Started

This manual contains procedures for: • • FME Desktop installation on Microsoft® Windows®, UNIX®, and Linux FME Desktop and FME Server licensing

1.1

If You Are Installing FME Server
For FME Server installation procedures, see the FME Server Administrator’s Guide, located at http://www.safe.com/support/onlinelearning/ documentation.php.

1.2

Before You Begin
Before installing FME, Safe Software recommends that you exit all programs, and ensure that the installation directory has access permission for all FME users who may log onto that computer.

1.3

Windows System Requirements
Supported Platforms • Windows 32-bit, including the following Microsoft products for FME Desktop or FME Server: – Windows 7 – Windows Vista – Windows 2008 Server – Windows 2003 Server – Windows XP • Windows 64-bit, including the following Microsoft products for FME Desktop or FME Server (a 64-bit build capable of addressing more than 4GB of memory): – Windows 7 – Windows Vista – Windows 2008 Server (with the win64 platform) 32-bit FME is supported on all Windows 64-bit editions, except for Windows XP. A native FME 64-bit technical preview is available. See the following link for more information: http://www.safe.com/support/beta/index.php

Minimum System Specifications • Intel® Pentium® III or 4 processor • 1 GB of RAM • 600 MB of available hard-disk space

Safe Software Inc.

1

Getting Started

• •

To install FME on a server for use with a thin-end client (for example, a Citrix® installation), you need to use FME floating licenses To install floating licenses, you must be running a TCP/IP network.

1.4

Linux and UNIX System Requirements
Supported Platforms • IBM® RS/6000 AIX 6.1 – for FME Server or FME Engine • Linux Intel x86 (Red Hat Enterprise Linux AS/ES/WS 4.0 or higher, or any Linux with glibc 2.3+ and gcc 3.4+) – for FME Server or FME Engine • Linux Intel x64 (Red Hat Enterprise Linux AS/ES/WS 5.0 or higher, or any Linux with glibc 2.5+ and gcc 4.1+) – for FME Server or FME Engine (a 64bit build capable of addressing more than 4GB of memory.) • Mac OS X 10.5 Leopard®/10.6 Snow Leopard® (Intel 32/64-bit Universal Binary) – for FME Engine only • Sun® SPARC Solaris™ 9, 10 – for FME Server or FME Engine

1.5

Determining the FME License Type to Install
Safe Software offers flexible licensing options for FME. The type of license that you receive (fixed, hardware-locked, or floating) is determined at the time of your request for evaluation or purchase. For specific information about Windows 64 licensing, see the following: • For FME Desktop, see the Windows 64 Licensing article in fmepedia at the following site: http://www.fmepedia.com/index.php/Windows_64_Licensing For FME Server, see the FME Server on Platforms Other than 32-bit Windows article in fmepedia at the following site:
http://www.fmepedia.com/index.php/FME_Server_on_Platforms_Other_than_32-bit_Windows

•

1.5.1

Fixed (Node-Locked) License
A single-fixed FME license is designed to enable FME to work on a single specified computer. • • Installing Fixed (Node-Locked) Licenses on Microsoft Windows on page 7 Installing Fixed (Node-Locked) Licenses on Linux and UNIX on page 21

1.5.2

Hardware-Locked License
A hardware-locked license is locked to a hardware key (or dongle). You can install FME on many computers, but FME can only be run when a dongle is attached to the computer. • Installing Hardware-Locked Licenses on Microsoft Windows on page 11

2

FME Installation and Licensing

1
1.5.3 Floating License
A floating license enables a number of concurrent users to simultaneously access a single FME deployment. FLEXlm technology provides the floating license capability to FME. For more information, visit Flexera’s Software’s website: http://www.flexerasoftware.com The FLEXlm software is installed on a computer that acts as a license server by issuing a license to any client computer that requests one. If the number of user requests exceeds the number of floating licenses purchased, a user waits until one of the active FME users closes FME on their computer so that the FME license is returned to the license server. • • Installing Floating Licenses on Microsoft Windows on page 13 Installing Floating Licenses on Linux and UNIX on page 23

Getting Started

1.6

FME Community
Our online community consists of an enthusiastic group of users and Safe Software staff who participate in various online resources. These technical resources are a forum where FME users ask questions, receive help, and exchange information on FME products. We welcome and encourage questions about FME formats, processing capabilities, future plans, documentation, FME Objects, mapping files, and coordinate conversion issues.

1.6.1

FME User Central
The FME User Central website is the access point that lets you quickly source various technical resources, and the latest news and technical bulletins. To access the resources described below, you can start from http://www.safe.com/fmeusercentral fmepedia fmepedia is Safe Software's user collaboration site. Based on Mediawiki, fmepedia is maintained both by Safe Software staff and members of our user community. FME Evangelist This technical blog delivers insider news, cutting edge examples, and the latest functional developments for Safe Software’s FME application. FME Talk FME Talk is a discussion group for the entire range of FME applications. Share your experiences, ask questions, and share your answers with other users here. FME Guru This technical resource is the FME YouTube™ channel. Here you find movies that show how to use FME.

Safe Software Inc.

3

Getting Started

FME Downloads From this location you can download software, beta versions of new releases, documentation, and other resources. FME Support and Training This is where you access online learning and information about: • • • • • training services downloads maintenance program technical support

4

FME Installation and Licensing

2
Chapter 2

Installing FME Desktop on Microsoft Windows
Installing
If you downloaded FME from www.safe.com, double-click the downloaded file. If you have an FME installation disk, insert it into the DVD drive. If the autorun feature is enabled on your computer, FME starts the installation process. If not, browse to the DVD drive, open the win32 folder, and double-click autorun.exe. Follow the instructions in the installation wizard.

2.1

2.1.1

Updating to a Newer FME Version
If you’re updating to a newer version of FME, follow these steps.
Note: Make sure you back up or relocate any custom files that you have saved in your FME installation directory.

1

When you install FME software and the installation wizard finds a previously installed version, you’re asked if you would like the wizard to uninstall it. If you do this, you can ignore this step and proceed to step 2. If you didn’t select to uninstall the previous version of your FME software, use the Add/Remove Programs option on the Control Panel to uninstall any existing versions of FME. You should not have more than one version of FME on your computer.

2

Insert the installation disk into the DVD drive. If the autorun feature is enabled on your computer, FME starts the installation process. If not, then browse to the DVD drive, open the win32 folder, and double-click autorun.exe. Follow the instructions in the installation wizard.

3

Safe Software Inc.

5

Installing FME Desktop on Microsoft Windows

6

FME Installation and Licensing

3
Chapter 3

Installing Fixed (Node-Locked) Licenses on Microsoft Windows

3.1

Requesting a Fixed (Node-Locked) License
To request a fixed license from Safe Software, follow these steps. 1 2 From the Windows Start menu, click Programs > FME Desktop > FME Licensing Wizard. The FME Licensing Wizard opens, as shown here:

3

If you installed FME from the installation disk, select I have a serial number, and would like to request a permanent license, and then click Next.
Note: Your serial number is printed on your welcome letter and your invoice. If you don’t know or can’t find your serial number, please send an e-mail to codes@safe.com requesting a license file. If you have an existing license file, please attach it.

4 5

Enter the serial number in the space provided. Safe Software sends the license to the e-mail address that you provide. Click Next. If you choose Connect directly to Safe Software, your request is sent as soon as you click Next. If you choose Generate e-mail, your e-mail application opens when you click Next, and a new e-mail shows the information required to generate and send a license. Send the e-mail to Safe Software. Click Finish to close the wizard.

6

Safe Software will send an e-mail message with a license file (*.fmelic) to the address you specified in step 4.

Safe Software Inc.

7

Installing Fixed (Node-Locked) Licenses on Microsoft Windows

3.2

Installing a Fixed (Node-Locked) License
1 2 3 From the Windows Start menu, select Programs > FME Desktop > FME Licensing Wizard. The FME Licensing Wizard opens. Select I would like to install a license already provided by Safe Software. Click Next to open the Select License File Type page:

4

Click the Node Locked License file option, and then click Next.

8

FME Installation and Licensing

3
5 You should have received your FME license file from Safe Software. Please locate this e-mail (and, if applicable, extract the attached file). You can either use the Browse button to locate the FME license (*.fmelic) file or copy the body of the e-mail into the space provided. Note that the body of the e-mail includes only the text from: *** start fme_license.fmelic *** to *** end fme_license.fmelic *** The following screen shows a partial example only:

Installing Fixed (Node-Locked) Licenses on Microsoft Windows

6

Click Next to complete FME licensing and close the wizard.

Safe Software Inc.

9

Installing Fixed (Node-Locked) Licenses on Microsoft Windows

10

FME Installation and Licensing

4
Chapter 4

Installing Hardware-Locked Licenses on Microsoft Windows

4.1

Installing a Hardware-Locked License
When you purchase a hardware-locked license, we send you a hardware lock, which is known as a dongle. You must attach the dongle to a USB port on the same computer on which you want to install and license FME. In this license mode, you are free to install FME on as many computers as you like; however, FME will only run on a computer on which you have installed the dongle and the license file. After it’s installed, running FME on any computer is as simple as attaching the dongle and starting FME. The dongle must remain attached to the computer for the duration of the FME session. To run FME on another computer, simply close FME, and move the dongle to the other computer. You must perform the following steps on each computer that will run FME.

4.1.1

Request a License
1 2 If you already have an fme_license.dat file, please proceed to Section 4.1.2 Start the FME Licensing Wizard . If you do not already have an fme_license.dat file, please send an e-mail to codes@safe.com requesting a license file for your serial number. Please include both your serial number and dongle identification. The serial number is printed on your welcome letter and on your invoice. The dongle identifier is found on the dongle itself. We will send you an fme_license.dat file.

4.1.2

Start the FME Licensing Wizard
1 Attach the USB dongle to the computer that has FME installed. The dongle is recognized and the dongle drivers are installed.
Note: You may need to manually install or update your dongle drivers if: • the dongle drivers do not install automatically • you are using FME 2008 or earlier Please go to http://www.aladdin.com/support/hasp.aspx and click HASP Runtime and Drivers setup.

2 3

From the Windows Start menu, select Programs > FME Desktop > FME Licensing Wizard. The FME Licensing Wizard opens. Select I would like to install a license already provided by Safe Software.

Safe Software Inc.

11

Installing Hardware-Locked Licenses on Microsoft Windows

4

Click Next.

5 6 7

Click the Hardware Locked License file option, and then click Next. You should have received your FME license file from Safe Software. Please locate this e-mail and save the attached FME license file to your computer. Click Browse to locate the FME license (*.dat) file.

8

Click Next to complete FME licensing and close the wizard.

FME is now ready to run using the hardware-locked license.

12

FME Installation and Licensing

5
Chapter 5

Installing Floating Licenses on Microsoft Windows

5.1

Installing a Floating License
An FME floating license allows a networked license server computer to provide FME floating licenses to multiple FME users on a network. It is highly recommended that FME is installed locally on each computer; however, it’s possible to install FME on a single network application server rather than on each desktop. You can use the floating license capability for all FME Editions and each license server can serve different FME licenses. For example, if a site requires floating licenses for both FME Base Edition and FME Smallworld Edition, you can choose both licenses from one floating license server.
Note: The preceding paragraph does not apply to floating licenses with different expiry dates.

5.1.1

Before You Begin
• • You must be running a TCP/IP network. Designate one computer on the network as the license server. The license server can be any computer on the network that’s visible to all computers that are dependent on it for their licenses. You should choose a computer that’s always running and always connected to the network because the client computers must be able to communicate with the license server to use the FME. The processing burden on the licensing server is negligible. You must have Administrator privileges to install the FME Floating License server. If the computer you want to use as your floating license server has a firewall, you must open a range of ports through which the FlexServer can communicate. By default, the range of ports used is 27000-27009, although you can also configure other ports. Please see Configuring the Floating License to Use a Specific Port on page 16.

• •

5.1.2

Download and Run the Installer
Perform these steps on the computer that acts as the license server. The FME installation disk contains the utility program that’s needed to get the license server up and running:
DVD:>Windows\FlexServer\SafeFLEXlmInstaller.msi

Safe Software Inc.

13

Installing Floating Licenses on Microsoft Windows

You can download the installer from Safe Software’s ftp site as well:
ftp://ftp.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi

or from:
http://downloads.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi

Run (double-click) the installer to create a flexserver directory. The following table lists the shortcuts that are created in the Safe Software program group.
Shortcut Description

Generate hostid.txt Launch LMTOOLS License Administration Guide

Creates text file to send to codes@safe.com. Launches LMTOOLS. Used for debugging or changing configuration. Opens Flexera Software’s License Administration Guide.

Start - Restart FME License Server Starts the license manager process. View FME License Server Log View hostid.txt View Readme Opens the license manager log file. Used for debugging. Reopens text file to send to codes@safe.com. Opens the installation and configuration instructions.

Note: You should use the current versions of lmgrd license manager and lmutil end user utilities, available from the Downloads area of www.flexera.com. The other files are required for new FME installations only.

5.1.3

Request and Install the License
Perform this step on the computer that acts as the license server. 1 Click Start > Programs > Safe Software > View hostid.txt to open the hostid.txt file.
Note: If you’re installing FLEXlm on Windows Vista, you need to right-click StartRestart FME License Server and run this function using Administrator privileges.

2

Copy and paste the contents of hostid.txt file to an e-mail. Include your FME serial number and name, and send it to codes@safe.com. (The serial number is printed on your welcome letter and on your invoice.) Safe Software will send you the license file. When you receive the safe.lic file, copy it into the FlexServer directory; for example, c:\program files\FlexServer\. Go to Start > Programs > Safe Software, and choose Start - Restart FME License Server.

3 4

14

FME Installation and Licensing

5
5.1.4 Install FME on Client Computers
After the license server is running, install FME on the client computers or on the Network Server (if you have a fast and non-congested network).

Installing Floating Licenses on Microsoft Windows

Note: If this is a license upgrade from fixed license to floating license (and not a new FME installation), then ensure that there are no existing fme_license.dat files in the licenses directory; for example, check C:\Program Files\FME\licenses. Also ensure there are no FME tasks running before starting the registration process.

5.1.5

Start FME Registration
Perform this step each computer that has FME installed. 1 To open the FME Licensing Wizard click Start > Programs > FME Desktop > FME Licensing Wizard, shown next.

2 3 4 5

Select I would like to connect to a floating license (FLEXlm) server and click the Next button. Enter the name of the computer that is hosting the FME licenses. If your floating license allows for more than one type of FME license, select the license that you want to use. Click Finish to complete the connection.

Now FME is ready to run using floating licenses.

Safe Software Inc.

15

Installing Floating Licenses on Microsoft Windows

5.2

Configuring the Floating License to Use a Specific Port
By default, the range of ports through which the FlexServer communicates is 27000-27009. However, you can also configure other ports. To configure the license server to communicate on a specific port, you need to make changes to the FlexServer license file and on the FME client computers. On the FlexServer computer, use a text editor to edit the first line of the safe.lic license file. (If you change any line other than the first line, the license file becomes invalid.) Add the port number to end of the line. For example, the first line would look like this (where the port number is 7500): SERVER worf 9-3a4b21b1 7500 .... On the FME client computer, you need to edit the fme_license.dat file in the FME installation directory, in the C:\Program Files\FME\licenses folder. Continuing with the above example, the fme_license.dat file would look like this: SERVER worf Any 7500 USE_SERVER

5.3

Installing a Permanent Three-Server Redundant Floating License Server
FLEXlm allows the option for redundancy by using a set of three license servers. With three-server redundancy, the floating license server stays functional, handing out its total complement of licenses when any two of the three license servers are up and running. A master server that performs all licensing operations is elected when the redundant servers are started. The other two servers are there to provide a secure licensing mechanism in the event of hardware failure or if the master node needs to be rebooted. It is not a requirement for each of the server nodes to have the same architecture or operating system, although they should have reliable network communications with each other and should be on the same subnet. Often this means that the three servers are located physically close to each other. If you have any questions about this topic, please send an e-mail message to us at codes@safe.com.

16

FME Installation and Licensing

5
5.3.1 Download and Run the Installer
The FME installation disk contains the utility program that is needed to get the license server up and running:

Installing Floating Licenses on Microsoft Windows

DVD:>Windows\FlexServer\SafeFLEXlmInstaller.msi

You can download the installer from Safe Software’s ftp site:
ftp://ftp.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi

or
http://downloads.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi

Run the installer to create a flexserver directory. The table that follows lists the shortcuts that are created in the Safe Software program group:
Shortcut Generate hostid.txt Launch LMTOOLS License Administration Guide Description Creates text file to send to codes@safe.com. Launches LMTOOLS. Used for debugging or changing configuration. Opens Flexera Software’s License Administration Guide.

Start - Restart FME License Server Starts the license manager process. View FME License Server Log View hostid.txt View Readme Opens the license manager log file. Used for debugging. Reopens text file to send to codes@safe.com. Opens the installation and configuration instructions.

Install the floating license server on three different computers using the instructions in the previous sections. Send an e-mail to codes@safe.com and include the FLEXlm Host ID, the hostname assigned to each of the computers. (The serial number is printed on your welcome letter and on your invoice.) We will e-mail you a file called safe.lic that contains the key code file for the license code servers. Copy the safe.lic file into each of the FlexServer directories on your license server nodes.

5.3.2

Start the License Servers
On all three servers, start the license manager. Go to Start > Programs > Safe Software, and run Start - Restart FME License Server.
Note: If you’re installing FLEXlm on Windows Vista, you need to right-click StartRestart FME License Server and run this function using Administrator privileges.

Safe Software Inc.

17

Installing Floating Licenses on Microsoft Windows

There is no time limit for starting all of the servers. The first server started of the first two servers that are listed in the fme_license.dat file becomes the master node. Start the servers in the order shown in the following example: SERVER host1 1223344 27009 SERVER host2 9384749 27009 SERVER host3 2038404 27009 VENDOR safe FEATURE FME . . . . . . Therefore the first server to start—host1—becomes the master node; host3 never becomes the master node. You can change the order of the SERVER lines to suggest which node is the master node, however we recommend you keep the order shown in the preceding example. Unlike independent servers, each SERVER line requires a port number. The port number for the preceding example is 27009. You can modify the port numbers to any unused port number in the range 1024 to 32000.

5.3.3

Install FME on Client Computers
When the server license files are running, install FME on the client computers or on the Network Server (if you have a fast and non-congested network). If this is not a new install (but rather a license upgrade from fixed license to floating), then ensure that there are no existing fme_license.dat or fme_license.fmelic files in the C:\Program Files\FME\licenses directory. Using a text editor, create a file called fme_license.dat that contains the same three SERVER lines from the safe.lic files that were used to start the redundant server nodes. Add a USE_SERVER line after the SERVER lines, as shown in the following example: SERVER host1 1223344 27009 SERVER host2 9384749 27009 SERVER host3 2038404 27009 USE_SERVER Place this fme_license.dat file under the FME client installation directory; that is, the C:\Program Files\FME\licenses directory.

18

FME Installation and Licensing

6
Chapter 6

Installing FME on Linux and UNIX

1

Insert the FME installation disk into the DVD drive. If your Linux or UNIX system does not mount the installation disk automatically, then mount it manually by typing a command such as: mount /mnt/cdrom where /mnt/cdrom is the mount point for your installation disk.
Note: This command may differ, depending on your system configuration, but the following steps assume the mount point shown above.

Locate the file for your architecture by looking in the directory on the installation disk named after your computer architecture:
Platform Solaris UNIX HP-UX 11 AIX Linux Location /mnt/cdrom/solaris2/fme-solaris.tar.gz /mnt/cdrom/hpux11/fme-hpux.tar.gz /mnt/cdrom/aix/fme-aix.tar.gz /mnt/cdrom/linux/fme-linux.tar.gz

2

Create the installation directory for FME. Ensure that it has read permission for all FME users. For example, if you have root privileges, you may want to create a directory at the root level: mkdir /opt/fme chmod a+r /opt/fme We have used the example directory /opt/fme, but depending on your system policies, you may want to install FME in a different directory or even in its own user account.
Note: You must perform the remaining steps under the same account; that is, you cannot unzip and untar the file as the root user, and then sign on as another user to perform the other steps.

3

Copy the applicable .gz file to the installation directory.
Note: To decompress the .gz files, you will need GNU gunzip (gzip). If you’re using Linux, gzip is already on your system.

4 5

Change to the installation directory: cd /opt/fme Decompress and untar the FME distribution: gunzip -d /mnt/cdrom/solaris/fme1024-solaris.tar.gz tar xfv /mnt/cdrom/solaris/fme1024-solaris.tar Remove the .tar file: /bin/rm fme1024-solaris.tar

6

Safe Software Inc.

19

Installing FME on Linux and UNIX

20

FME Installation and Licensing

7
Chapter 7

Installing Fixed (Node-Locked) Licenses on Linux and UNIX

A single-fixed FME license is designed to enable FME to work on a single specified computer. If more than one user installs FME, each user has to install a fixed license on their computer.

7.1

Installing a Node-Locked License
1 Ensure your working directory is the installation directory, and then run the runfme program (with no arguments) to obtain the registration number: ./runfme Unless there is licensing information already present in this location, you receive an error message that includes the computer registration number: FME license system failure. Contact your Distributor. Your machine key is 1-234-567-890. Write down the 10-digit number and send an e-mail message to codes@safe.com. Include your operating system type and version number; for example, Solaris 2.6. We will send you an .fmelic license file. To register this license from the install directory, run this command: runfme <licensefilebaseName.fmelic>
Note: Remember that you must register FME as the same user who untarred the installation file.

2

The easiest way to run FME is to use the runfme script. This script sets the FME_HOME and LD_LIBRARY_PATH (or LIBPATH or SHLIB_PATH, depending on the platform) environment variables, and then runs FME. For best results, store the runfme script in the same directory as the FME and its other support files. If the FME installation directory is in the user's path, you can run the runfme script as follows: runfme <normal FME arguments> If the script is moved out of the FME installation directory, it must be updated so that the default value of FME_HOME points to the installation directory.

Safe Software Inc.

21

Installing Fixed (Node-Locked) Licenses on Linux and UNIX

3

All users who want to access FME without using the runfme script must have their environments set up correctly. This is normally done by adjusting each user’s login script to set the FME_HOME environment variable, and adding FME_HOME/fmecore into the PATH and LD_LIBRARY_PATH environment variables. (The latter is named LIBPATH on AIX and SHLIB_PATH on HP-UX.) The way to make this change depends on your configuration and which UNIX shell you use; however, if you use the C-Shell, you can set up your own environment by adding these lines to your .cshrc: setenv FME_HOME /opt/fme set path = ($path $FME_HOME) setenv LD_LIBRARY_PATH $FME_HOME/fmecore:$LD_LIBRARY_PATH Your System Administrator may be able to make changes in one place so they can be accessed by all users. Alternatively, you can edit the runfme script in the FME installation directory. The script’s header comments outline the required modifications.

7.1.1

Updating the FME Version
If you’re updating to a newer version of FME, follow these steps: 1 2 3 4 Copy the .fmelic license file from your existing FME installation directory to a safe place. After you have installed the new FME version, copy the .fmelic license file to your new FME installation directory. If you installed in a different directory, adjust your PATH and LD_LIBRARY_PATH to the new directory. Start FME.
Note: You can store multiple versions of FME for UNIX; however, Safe Software recommends that you keep only one version active.

22

FME Installation and Licensing

8
Chapter 8

Installing Floating Licenses on Linux and UNIX

A floating license enables a number of concurrent users to simultaneously access a single FME deployment. FLEXlm technology provides the floating license capability to FME. For a full description, visit Flexera Software’s website: http://www.flexera.com The FLEXlm software is installed on a computer that acts as a license server by issuing a license to any client computer that requests one. If the number of user requests exceeds the number of floating licenses purchased, a user will need to wait until one of the active FME users closes FME on their computer so that the FME license is returned to the license server. • • • Preparing for a New Floating License on page 24 Installing a New Floating License on page 25 Configuring FME to Use a Floating License on page 26

8.1

Before You Begin
• • You must be running a TCP/IP network. One computer on the network is designated as the license server. The license server may be any computer on the network that is visible to all computers that are dependent on it for their licenses. You should choose a computer that is always running and always connected to the network because the client computers must be able to communicate with the license server to use the FME. The processing burden on the licensing server is negligible. You must have Administrator privileges to install the FME Floating License server. If the computer you want to use as your floating license server has a firewall, you must open a port through which the FlexServer can communicate. By default, the range of ports used is 27000-27009, although you can also configure other ports. Please see Configuring a Floating License to Use a Specific Port on page 26.

• •

8.2

Locating the FLEXlm License Server Files
Please read and understand the following steps before attempting to use FLEXlm licensing on Solaris™, HP-UX, or Linux on x86 and x64. If you have purchased an FME floating or node-locked license for UNIX, copy the solaris2\FlexServer or hpux11\FlexServer directories from the FME installation disk, or go to Safe Software’s FTP site and save one of the following files: • ftp://ftp.safe.com/fme/floatingLicense/FlexServer_solaris_11_6.tar.gz

Safe Software Inc.

23

Installing Floating Licenses on Linux and UNIX

• • • •

ftp://ftp.safe.com/fme/floatingLicense/flexserver-hpux_8_2.tar.gz ftp://ftp.safe.com/fme/floatingLicense/FlexServer-linux-x64.tar.gz ftp://ftp.safe.com/fme/floatingLicense/FlexServer-linux-x86.tar.gz ftp://ftp.safe.com/fme/floatingLicense/flexserver-solaris_8_2.tar.gz

This directory contains the lmutil and lmgrd files that you’ll need to set up a FLEXlm server on UNIX, and it contains the FLEXlm license server software. You should install this software on your license server computer, which is the computer that will manage the licenses.
Note: Current versions of lmgrd license manager and lmutil end user utilities are also available from the Downloads area of www.flexera.com.

8.3

Preparing for a New Floating License
There are several things you must do to prepare to install a new floating license, each of which is described here.

8.3.1

Creating a Directory for the FLEXlm License Server
You need to create a directory for the FLEXlm license server and extract the contents of flexserver-solaris_8_2.tar.gz or flexserver-hpux_8_2.tar.gz into this directory. For example: % mkdir /opt/FlexServer % cd /opt/FlexServer % gunzip < ~/flexserver-solaris_8_2.tar.gz | tar xf This directory is referred to as the FlexServer directory for the remainder of these instructions.

8.3.2

Providing the Information to Generate a Floating License
Safe Software requires three pieces of information to generate a floating or node-locked license: • • • hostname host ID FME serial number

Obtaining the Hostname
To obtain the hostname, type the hostname command. For example: % hostname worf In this example, the host name is worf.

24

FME Installation and Licensing

8
Determining the host ID
To determine the host ID, use the lmutil lmhostid command within the FlexServer directory. The output should be an eight-character alphanumeric string (or a 12-character alphanumeric string on Linux). For example: % ./lmutil lmhostid lmutil - Copyright (c) 1989-2004 The FLEXlm host ID of this machine is "807abc12" In this example, the host ID is 807abc12.

Installing Floating Licenses on Linux and UNIX

Determining the FME Serial Number
To determine the serial number, look at your welcome letter or your invoice. Send an e-mail message to codes@safe.com and include the host ID, the host name, and the FME serial number. Safe Software will e-mail you a file called safe.lic that contains the key code file for the license code server. Copy the safe.lic file into the FlexServer directory on your license server computer.
Note: The filename must remain in lowercase text. Safe Software recommends that you do not change the filename. If you want to change the file contents (for example, change a port number), please refer to the FLEXlm User’s Guide, available on your FME installation disk.

8.4

Installing a New Floating License
Note: To start the Flex Server, you must have a /usr/tmp directory. Verify that the /usr/tmp directory exists and if it doesn’t exist, create this directory as follows: % mkdir /usr/tmp

To start the license server: % <FlexServerDir>/lmgrd -c <FLEXServerDir>/safe.lic This action runs the server in the foreground, logging activity to the terminal. To store the log to a file instead, use the -l option: % ./lmgrd -c ./safe.lic -l safe.log When a log file is used, lmgrd detaches as a background process, so there is no need to explicitly background the application. However, you’ll have to start the server each time the license server host is rebooted. The system administrator can make sure the preceding command is run at system start-up time.

Safe Software Inc.

25

Installing Floating Licenses on Linux and UNIX

8.5

Configuring FME to Use a Floating License
To configure an installation of FME to use a particular license server, follow the steps provided below to create a text file called fme_license.dat in the FME license directory. The license server may or may not be the host where FME is installed, and could even be a Windows host that is already running floating licenses.
Note: Any examples shown here are simple configurations based on default port numbers. However, FLEXlm lets you set up other configurations, as well as specify locations for the license server through environment variables. If you want to do this, please skip the steps that follow and refer to detailed instructions in the FLEXlm User’s Guide.

The safe.lic file we provide when you’re preparing to install a floating license is used to configure the floating license server. It is necessary for each FME installation to have a separate fme_license.dat file that tells FME which computer to connect with when looking for license information. 1 Remove existing license files. Make sure that the FME installation directory is cleared of any files named fme_license.dat and fme_license.fmelic. 2 Create a file that contains the following information: SERVER <ServerHostName> Any USE_SERVER In a few of the previous examples, the server was installed onto a host named worf on a local network, using the default port number. The following command uses this example to create the needed license file. % cd /opt/FME2008 % cat > fme_license.dat SERVER worf Any USE_SERVER <Ctrl+d> (Typing Ctrl+d ends the input to fme_license.dat.)

8.6

Configuring a Floating License to Use a Specific Port
To configure the license server to communicate on a specific port, you need to make changes to the FlexServer license file and on the FME client computers. On the FlexServer computer, use a text editor to edit the first line of the safe.lic license file. (If you change any line other than the first line, the license file becomes invalid.) Add the port number to end of the line. For example, the first line would look like this (where the port number is 7500): SERVER worf 9-3a4b21b1 7500 ....

26

FME Installation and Licensing

8
On the FME client computer, you need to edit the fme_license.dat file in the FME installation directory, in the \Licenses folder. Continuing with the preceding example, the fme_license.dat file would look like this: SERVER worf Any 7500 USE_SERVER

Installing Floating Licenses on Linux and UNIX

8.7

Starting FME from the Command Line
The Linux and UNIX versions of FME operate directly from the command line. Type: runfme For more information about using FME from the command line, see the following references: • • Start the FME Universal Translator and open the FME Fundamentals book from the Help menu. Open the Command-Line Interface topic. If you don’t have access to the user interface, open the help folder and double-click the file FMEFundamentals.chm.

Safe Software Inc.

27

Installing Floating Licenses on Linux and UNIX

28

FME Installation and Licensing

9
Chapter 9

Installing Grid Shift Files

9.1

Installing Grid Shift Files on Microsoft Windows
FME supports conversions between coordinate systems using different datums. Many datum transformations are not mathematically definable and require the use of grid of shifts. If you attempt to perform a datum transformation of this kind without the appropriate grid shift file in place, FME stops the translation. When you install FME for Windows, the grid shift files provided by Safe Software are automatically installed in the correct location. If you have already installed FME, you can find more information on which files are included by opening Workbench help and clicking on the Coordinate Systems topic, or by choosing Tools > Browse Coordinate Systems and pressing the F1 key. You can manage grid shift files by choosing Tools > FME Options > Coordinate Systems.

Click the Help button for more information on how you can maintain grid shift files.

Safe Software Inc.

29

Installing Grid Shift Files

9.2

Installing Grid Shift Files on Linux or UNIX
When you install FME for Linux/UNIX, the grid shift files provided by Safe Software are automatically installed in the correct locations. You can find more information on which files are included in Linux and UNIX installations by viewing our fmepedia site: fmepedia.com/index.php/Datum_Transformations_and_Grid_Shift_Files The files in the Reproject subdirectory of your FME installation folder include a path to the location of your grid file. The order in which the grids are listed is the order in which FME uses them. To register a file, add the full pathname of the file to the beginning of the appropriate .gdc file. For example, in Nad27ToNad83.gdc, add: fmehome\Reproject\GridData\Canada\NTV2_0.gsb To make sure the files were registered correctly, check the log file when you run a translation.
Note: If you have access to the FME Workbench user interface, you can manage grid shift files through the Workbench > Tools > FME Options menu. Click the Coordinate Systems icon.

30

FME Installation and Licensing

10
Chapter 10

Using FME Desktop with Third-Party Applications

FME Desktop integrates with a number of popular GIS applications. Visit www.safe.com for more information. This chapter provides instructions for using the FME Administrator to extend any applicable third-party applications.

10.1 FME Administrator
The FME Administrator detects any supported third-party applications that are already installed on your system. When you install a new FME license using the FME Licensing Wizard, the FME Administrator attempts to extend all installed third-party applications that are supported by the FME license. To open the FME Administrator, find your FME folder in the Windows Start menu, and choose FME Administrator:

If your computer contains any installed applications that are supported by your FME license, they are listed in this window, along with their current state. The Current State lists the build number that extends the application. This build number changes each time you update FME.

10.1.1 Reverting and Extending Applications
To revert an application to a Not Extended state, click the Revert button. To extend an application (for example, if you install a supported application after you install FME), click the Extend button.

Safe Software Inc.

31

Using FME Desktop with Third-Party Applications

10.1.2 Viewing Details and Options
To see details about an application (in either state), including the minimum build of FME required to extend it, click Details. You can perform system administration tasks and set configuration options for some applications by clicking the Options button.

32

FME Installation and Licensing


				
DOCUMENT INFO
Shared By:
Stats:
views:987
posted:1/14/2010
language:English
pages:36
Description: Download FME Installation and Licensing Manual