FME DesktopInstallationandLicensingManual FME ...docs.safe.com/fme/2013sp2/pdf/FMEInstallationLicensing_print.pdf · FME DesktopInstallationandLicensingManual – FME DesktopVersion2013SP2

FME Desktop Installation and Licensing Manual–

FME Desktop Version 2013 SP2

This manual contains procedures for:

n FME Desktop installation on Microsoft® Windows®, UNIX®, andLinux®

n FME Desktop licensing

Installing and Licensing FME Server

For complete FME Server installation and licensing procedures, see theFME Server Administrator’s Guide, located at http://FME-pedia.safe.com/articles/How_To/Installing-FME-Server.

http://fmepedia.safe.com/articles/How_To/Installing-FME-Server

Safe Software Inc. makes no warranty either expressed or implied,including, but not limited to, any implied warranties of merchantabilityor fitness for a particular purpose regarding these materials, and makessuch materials available solely on an “as-is” basis.

In no event shall Safe Software Inc. be liable to anyone for special, col-lateral, incidental, or consequential damages in connection with orarising out of purchase or use of these materials. The sole and exclusiveliability of Safe Software Inc., regardless of the form or action, shall notexceed the purchase price of the materials described herein.

This manual describes the functionality and use of the software at thetime of publication. The software described herein, and the descriptionsthemselves, are subject to change without notice.

Copyright

© 1994 – 2013 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 andwould appreciate being informed of any errors found. Safe SoftwareInc. 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 doc-ument or their consequences, and reserves the right to make improve-ments and changes to this document without notice.

Trademarks

FME is a registered trademark of Safe Software Inc.

Welcome

http://www.safe.com/

Welcome

All brands and their product names mentioned herein may be trademarksor registered trademarks of their respective holders and should be notedas such.

Document Information

Document Name:Version: FME Desktop 2013 SP2Updated: May 2013

Contents

1 Getting Started, and System Requirements 1

1.1 Before You Begin 11.2 Windows System Requirements 1

1.2.1 Supported Platforms 11.2.2 Minimum System Specifications 21.2.3 Recommended System Specifications 2

1.3 Linux and UNIX System Requirements 21.4 Virtualization 31.5 Determining the FME License Type to Install 3

1.5.1 Single-Fixed License 31.5.2 Floating License 3

1.6 FME Community 41.6.1 FMEpedia Community and Knowledge Base 41.6.2 FME Training 4

2 Installing FME Desktop on Microsoft Windows 5

2.1 Updating to a Newer FME Version 5

3 Installing a Single, Fixed License on Microsoft Windows 7

3.1 Before You Begin 73.2 Activating a Single-Fixed License 7

3.2.1 Installing a License File Provided by Safe Software 8

4 Installing a Floating License Server on Microsoft Windows 11

4.1 Before You Begin 114.2 Download and Run the Installer 124.3 Request and Install the License 134.4 Install FME on Client Computers 154.5 Start FME Registration 15

5 Installing a Permanent Three-Server Redundant FloatingLicense Server 17

5.1 Download and Run the Installer 175.2 Start the License Servers 185.3 Install FME on Client Computers 19

6 Borrowing a Floating License 21

6.1 Connect to the Floating License Server 216.2 Specify the Terms of the License 236.3 Return the License 24

Welcome

Welcome

7 Installing FME Desktop on Linux and UNIX 27

7.1 Installing FME Desktop on Linux 27

8 Installing Single-Fixed Licenses on Linux and UNIX 31

8.1 Before You Begin 318.2 Installing Single-Fixed Licenses on Linux 31

8.2.1 Installing a License File Provided by Safe Software 328.3 Installing Single-Fixed Licenses on UNIX 34

8.3.1 Updating the FME Version 35

9 Installing Floating Licenses on Linux and UNIX 37

9.1 Before You Begin 379.2 Locating the FLEXlm License Server Files 389.3 Preparing for a New Floating License 38

9.3.1 Creating a Directory for the FLEXlm License Server 389.3.2 Providing the Information to Generate a Floating License 39

9.4 Installing a New Floating License 409.5 Configuring FME Desktop to Use a Floating License 41

9.5.1 Configuring FME Desktop on Linux 419.5.2 Configuring FME Desktop on UNIX 43

9.6 Installing a Permanent Three-Server Redundant Floating LicenseServer 44

9.6.1 Download and Run the Installer 449.6.2 Start the License Servers 449.6.3 Run the FME Licensing Assistant and Connect to the FirstServer 46

9.7 Starting FME from the Command Line 46

10 Installing Grid Shift Files on Microsoft Windows 47

11 Installing Grid Shift Files on Linux or UNIX 49

12 Using FME Desktop with Third-Party Applications 51

12.1 FME Integration Console 5112.1.1 Reverting and Extending Applications 52

1 Getting Started, and System Requirements

1.1 Before You Begin

Before installing FME Desktop, Safe Software recommends that you exitall programs, and ensure that the installation directory has access per-mission for all FME users who may log onto that computer.

1.2 Windows System Requirements

1.2.1 Supported Platforms

Note: Both 64- and 32-bit versions of the following Windows plat-forms are supported, except where specified.

n Windows 8

n Windows 7

n Windows Vista SP2

n Windows 2012 Server

n Windows 2008 Server R2

n Windows 2008 Server

n Windows 2003 Server SP2

n Windows XP SP3 (32-bit only)

Note: All 64-bit Windows editions listed above also support 32-bitFME. See the Guide for Running 64-bit FME for details on dif-ferences between 32-bit and 64-bit FME.

1

http://fmepedia.safe.com/articles/FAQ/A-guide-to-running-64-Bit-FME

1.2.2 Minimum System Specifications

System specifications will vary depending on your FME usage, includingthe size of your data files. However, at minimum, we recommend:

n Intel® Pentium® III or 4 processor

n 2 GB of RAM

n 4 GB of available hard-disk space

1.2.3 Recommended System Specifications

Note: FME will operate well with the minimum recommendedconfiguration; however, any application benefits fromadditional resources. For large processing tasks, addi-tional memory and a fast disk can measurably improveprocessing time.

n Intel® Core i7 CPU

n 8 GB of RAM

n 50 GB of available hard-disk space

n A Solid-State Drive (SSD)

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

1.3 Linux and UNIX System Requirements

Safe Software provides a FME Desktop Light edition. This edition doesnot include the Workbench component.

Supported Platform

n Linux Intel x64 (64-bit Red Hat Enterprise Linux 5) (linux-x64)


2

1.4 Virtualization

For more information on support of this platform, please contact [email protected].

1.4 Virtualization

FME Desktop can be run on the following virtual platforms:

n Amazon Web Services (AWS) Elastic Compute Cloud (EC2)

n VMware virtual machines

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 or floating) is determined atthe time of your request for evaluation or purchase.

1.5.1 Single-Fixed License

A single-fixed FME license is designed to enable FME to work on a singlespecified computer.

n "Installing Single-Fixed Licenses on Linux" on page 31.

n "Installing Single-Fixed Licenses on UNIX" on page 34.

1.5.2 Floating License

A floating license enables a number of concurrent users to simultaneouslyaccess a single FME deployment. FLEXlm technology provides the floatinglicense capability to FME. You can download the Safe FLEXlm installerfrom:

http://www.safe.com/support/downloads.php

The FLEXlm software is installed on a computer that acts as a licenseserver by issuing a license to any client computer that requests one. Ifthe number of user requests exceeds the number of floating licenses pur-chased, a user waits until one of the active FME users closes FME on theircomputer so that the FME license is returned to the license server.

3


n "Installing a Floating License Server on Microsoft Windows" onpage 11

n "Installing Floating Licenses on Linux and UNIX" on page 37

1.6 FME Community

Our online community consists of an enthusiastic group of users andSafe Software staff who participate in various online resources. Thesetechnical resources are a forum where FME users ask questions, receivehelp, and exchange information on FME products. We welcome andencourage questions about FME formats, processing capabilities, futureplans, documentation, FME Objects, mapping files, and coordinate con-version issues.

1.6.1 FMEpedia Community and Knowledge Base

Ask questions and share advice at the new question and answer site forFME users: FME Community Answers.

FMEpedia Knowledge Base contains informative resources and toolsdesigned to help you optimize your use of FME Desktop and FME Server.

1.6.2 FME Training

Safe Software provides courses and resources for both FME Desktop andFME Server, offered at a range of skill levels. You can choose how youwant to learn: in-person, on-line instructor-led, or with self-pacedresources like tutorials and demos.

To access these resources, visit http://www.safe.com/training/.


4

http://fmepedia.safe.com/answerssearch

http://fmepedia.safe.com/knowledgeoverview

http://www.safe.com/training/

2 Installing FME Desktop on Microsoft WindowsIf you downloaded FME from www.safe.com, double-click the downloadedfile and click Run when prompted.

If you have an FME installation disk, insert it into the DVD drive. If theautorun feature is enabled on your computer, FME starts the installationprocess. If not, browse to the DVD drive and double-click autorun.exe.

On the Welcome to FME Desktop menu, click Install FME Desktop.

Follow the instructions in the installation wizard.

2.1 Updating to a Newer FME Version

If you are updating to a newer version of FME using an installation disk,follow these steps.

Note: Make sure you back up or relocate any custom files thatyou have saved in your FME installation directory.

1. Insert the installation disk into the DVD drive. If the autorun featureis enabled on your computer, FME starts the installation process. Ifnot, browse to the DVD drive and double-click autorun.exe.

2. Specify a destination folder and click Next. If the installation wizardfinds a previously installed version of FME in the specified des-tination folder, the installation wizard asks if you would like to unin-stall it. If you answer yes, proceed to step 4. If you answer no, youmust manually uninstall the previous version before proceeding toStep 3.

3. On the Welcome to FME Desktop menu, click Install FME Desktop.

4. Follow the remaining instructions in the installation wizard.

5

6

3 Installing a Single, Fixed License on MicrosoftWindows


Your serial number is printed on your welcome letter and your invoice. Ifyou do not know or cannot find your serial number, please send an e-mailto [email protected] to request a license file.

To activate your license you will need an Internet connection.

Note: Fixed licenses do not work with virtual machines that arebuilt and moved around among many physical machines.Installing FME on a virtual machine requires a floatinglicense. For further details, please refer to "Installing aNew Floating License" on page 40.

3.2 Activating a Single-Fixed License

If you have a serial number and an Internet connection, follow thesesteps to activate a fixed license from Safe Software.

Note: If you already have a licensed installation, you will beprompted to update it.

1. From the Windows Start menu, click Programs > FME Desktop >Utilities > FME Licensing Assistant.

2. The FME Licensing Assistant opens.

3. Select Activate a single-fixed license. Enter the Serial Number inthe corresponding field, and click Activate.

7

mailto:[email protected]

4. Click Finish.

You will see a confirmation message when FME Desktop is suc-cessfully licensed.

Other Licensing Options

Three additional licensing options are available in this dialog.

n To connect to a floating license server, see "Installing a FloatingLicense Server on Microsoft Windows" on page 11.

n To activate a trial version of FME, visit: http://www.safe.-com/evaluation/index.php

n To install a license file provided by Safe Software, see "Installinga License File Provided by Safe Software" on page 32.

3.2.1 Installing a License File Provided by Safe Software

Follow the steps below if you have a problem with the automated licensegenerator. If this happens, you will need to install a license file

3 Installing a Single, Fixed License on Microsoft Windows

8

http://www.safe.com/evaluation/index.php

3.2 Activating a Single-Fixed License

(*.fmelic) provided by Safe Software.

If you already have the license file, active a single-fixed license by fol-lowing these steps:

1. Send an e-mail message to [email protected] with the following:

n serial number

n your 10-digit registration key, which is located at the bottom leftcorner of the install pane of the FME Desktop Licensing Assistant:

Note that the number shown here is an example only.

You will receive an e-mail message from Safe Software with an attached.fmelic license file. Note for Linux users: Once FME Desktop isinstalled, log in as the same user who installed FME Desktop.

1. Navigate to FME Desktop > Utilities > FME Licensing Assistant (onWindows, this is in the Start menu). The FME Desktop LicensingAssistant opens.

2. Click Install a license file provided by Safe Software.

3. Browse to the location of your license file and click Activate.

9

4. Click Finish.

FME Desktop is successfully licensed.

Note: Licenses are tied to physical properties of systems. If youchange your system's hardware configuration, your FMElicense may not work and you will need to request a newone.

3 Installing a Single, Fixed License on Microsoft Windows

10

4 Installing a Floating License Server on MicrosoftWindows

An FME floating license allows a networked license server computer toprovide FME floating licenses to multiple FME users on a network. It ishighly recommended that FME is installed locally on each computer; how-ever, it is possible to install FME on a single network application serverrather than on each desktop.

You can use the floating license capability for all FME editions, and eachlicense server can serve different FME licenses. For example, if a siterequires floating licenses for both FME Base Edition and FME SmallworldEdition, you can choose both licenses from one floating license server.

Note: The preceding paragraph does not apply to floatinglicenses with different expiry dates.

If you need to transfer an existing floating license to a new licenseserver, you have to perform a new installation since you still need torequest a new license file to Safe Software.


Ensure that the following requirements are met before beginning theinstallation:

n You must be running a TCP/IP network.

n You must designate one computer on the network as the licenseserver. The license server can be any computer on the network thatis visible to all computers that are dependent on it for theirlicenses. Select a computer that is always running and always con-nected to the network, because the client computers must be ableto communicate with the license server to use FME. The processingload on the licensing server is negligible.

11

n You must have administrator privileges to install the FME floatinglicense server.

n If the computer you want to use as your floating license serverhas a firewall, you must open a range of ports through which theFlexServer can communicate.

n If FLEXlm is already installed on your license server, you stillneed to perform a new installation. FME 2011 requires the versionof FLEXlm that is included in the installer. In addition, if yourorganization is configuring license borrowing (see "Borrowing aFloating License" on page 21), you will require LMTOOLS version11.8 or newer.

Note: The FME license server cannot be installed on a virtualmachine that is built and moved around among manyphysical machines. It must be locked to a single fixedMAC address.

4.2 Download and Run the Installer

The FME installation disk contains the utility program required to get thelicense server up and running:

DVD:>FLEXlmLicenseServer\FlexServer11_8-windows-x86.msi

You can download the installer from Safe Software’s site as well:


Perform the following step on the computer that acts as thelicense server:

1. Run (double-click) the installer to create a FlexServer directory.

The following table lists the shortcuts that are created in the SafeSoftware program group.

Shortcut Description

Generate hostid.txt Creates text file to send to

4 Installing a Floating License Server on Microsoft Windows

12

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

4.3 Request and Install the License


[email protected].

Launch LMTOOLS Launches LMTOOLS. Used for debug-ging or changing configuration.

License AdministrationGuide

Opens Flexera Software’s LicenseAdministration Guide.

Start - Restart FMELicense Server

Starts the license manager process.

View FME License ServerLog

Opens the license manager log file.Used for debugging.

View hostid.txt Reopens text file to send [email protected].

View Readme Opens the installation and con-figuration instructions.

Note: You should use the current versions of lmgrd licensemanager and lmutil end user utilities, availablefrom Flexera Software. The other files are requiredfor new FME installations only.

4.3 Request and Install the License

Perform the following steps on the computer that acts as thelicense server:

1. Click Start > Programs > Safe Software > View hostid.txt to openthe hostid.txt file.

Note: If you are installing FLEXlm on Windows Vista, Win-dows 7, or Windows 8 and User Account Control(UAC) is enabled, right-click Start-Restart FMELicense Server and run this function using

13

http://learn.flexerasoftware.com/content/ELO-LMGRD

administrator privileges. If UAC is not enabled, youdo not have to perform this step.

2. Complete the online license request form:

http://www.safe.com/activation/floating/

You will need either:

n A trial activation code (e.g. EDHAKQ5W) or

n A product serial number (e.g. BEGP-F7MG-21YL).

Note: If you don't have a trial activation code or productserial number, please email your hostid.txt file [email protected]

If you are requesting a combined license and are entering multipleserial numbers, separate them with commas.

If you do not have hostid.txt and are entering host informationmanually:

n Hostname is the name of the computer hosting the floatinglicense.

n Host ID is the MAC address (or "Ethernet address") of thehost computer.

Note: Your hostid.txt may contain multiple Host IDs; how-ever, you can enter only one in the online requestform.

3. You will receive an email with instructions for installing thelicense:

a. Save the safe.lic file to the FlexServer directory. Forexample: C:\Program Files\FlexServer\


14

http://www.safe.com/activation/floating/

4.4 Install FME on Client Computers

b. Restart the FME License Server:

Start Menu > Programs > Safe Software> Start - Restart FMELicense Server


After the license server is running, install FME on the client computers oron the Network Server (if you have a fast and non-congested network).

Note: If this is a license upgrade from fixed license to floatinglicense (and not a new FME installation), then ensure thatthere are no existing fme_license.dat files in the licensesdirectory; for example, check C:\Program Files\FME\li-censes. Also ensure there are no FME tasks running beforestarting the registration process.

4.5 Start FME Registration

Perform this step for each computer that has FME installed.

1. To open the FME Licensing Assistant, click Start > Programs > FMEDesktop > Utilities > FME Licensing Assistant.

15

2. Select Connect to a floating license server, and enter the name ofthe computer that is hosting the FME licenses.

3. Click the Next button.

4. If your floating license allows for more than one type of FMElicense, select the license that you want to use.

5. Click Finish to complete the connection.


16

Installing a Permanent Three-Server Redundant Floating License

5 Installing a Permanent Three-Server RedundantFloating License Server

FLEXlm allows for redundancy by using a set of three license servers.With three-server redundancy, the floating license server stays func-tional, handing out its total complement of licenses when any two of thethree license servers are up and running.

A master server that performs all licensing operations is elected when theredundant servers are started. The other two servers are there to providea secure licensing mechanism in the event of hardware failure or if themaster node needs to be rebooted.

It is not a requirement for each of the server nodes to have the samearchitecture or operating system, although they should have reliable net-work communications with each other and should be on the same subnet.Often, this means that the three servers are located physically close toeach other.

If you have any questions about this topic, send an e-mail message withyour questions to [email protected].

5.1 Download and Run the Installer

The FME installation disk contains the utility program that is needed to getthe license server up and running:

DVD:>FLEXlmLicenseServer\FlexServer11_8-windows-x86.msi

You can download the installer from Safe Software’s ftp site:

ftp://ftp.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi

Note: If you are viewing this link in a PDF file, your Acrobatsecurity settings may prevent access to the installer. Youcan paste the above link into a web browser.

You can also download the installer from Safe Software's web site:


Run the installer to create a flexserver directory.

ftp://ftp.safe.com/fme/floatingLicense/SafeFLEXlmInstaller.msi


The table that follows lists the shortcuts that are created in the Safe Soft-ware program group:


Generate hostid.txt Creates text file to send to [email protected].

Launch LMTOOLS Launches LMTOOLS. Used for debuggingor changing configuration.

License Administration Guide Opens Flexera Software’s LicenseAdministration Guide.

Start - Restart FME LicenseServer

Starts the license manager process.

View FME License Server Log Opens the license manager log file.Used for debugging.

View hostid.txt Reopens text file to send [email protected].

View Readme Opens the installation and configurationinstructions.

Install the floating license server on three different computers using theinstructions in the previous sections.

Send an e-mail to [email protected] and include the FLEXlm Host ID, thehostname assigned to each of the computers. (The serial number is prin-ted on your welcome letter and on your invoice.)

We will e-mail you a file called safe.lic that contains the key code filefor the license code servers. Copy the safe.lic file into each of theFlexServer directories on your license server nodes.

5.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, right-clickStart-Restart FME License Server and run this functionusing administrator privileges.

The first server started of the first two servers 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 27009SERVER host2 9384749 27009SERVER host3 2038404 27009VENDOR safeFEATURE FME . . .. . .

Therefore, the first server to start—host1—becomes the master node;host3 never becomes the master node.

There is no time limit for starting all of the servers.

Unlike independent servers, each SERVER line requires a port number.The port number in this example is 27009. You can modify the port num-bers to any unused port number in the range 1024 to 32000.

You can change the order of the SERVER lines to suggest which node is themaster node, however we recommend you keep the order shown in thepreceding example.


When the server license files are running, install FME on the client com-puters or on the Network Server (if you have a fast and uncongested net-work). If this is not a new install (but rather a license upgrade from fixedlicense to floating), ensure that there are no existing fme_license.dat orfme_license.fmelic files in the C:\Program Files\FME\licenses dir-ectory.

Using a text editor, create a file called fme_license.dat that containsthe same three SERVER lines from the safe.lic files that were used to

start the redundant server nodes. Add a USE_SERVER line after theSERVER lines, as shown in the following example:

SERVER host1 1223344 27009SERVER host2 9384749 27009SERVER host3 2038404 27009USE_SERVER

Place this fme_license.dat file in the FME client installation directory;that is, in the C:\Program Files\FME\licenses directory.


Borrowing a Floating License

6 Borrowing a Floating LicenseIf your FME Desktop product uses a floating license, and your organ-ization supports this option, you can borrow a license for offline use.

A fixed license configuration does not allow you to borrow a license. Inaddition to a floating license, you need a floating license server with thelicense borrowing capabilities enabled.

Note: Note that license borrowing requires LMTOOLS version11.8 or newer.

If a license is available, you can borrow it and run FME for a maximum of7 days on a computer that is no longer connected to the license server.

Note: If you need to borrow a license for an extended time,please consult your System Administrator.

When the borrowing period expires, the license also expires. After theexpiry date, the license automatically becomes available for other usersto borrow.

You do not have to return the license after an expiry date; however, youcan choose to return a license early. See "Return the License" on page 24.

6.1 Connect to the Floating License Server

To borrow a license, you first need to connect to a floating license server.(Please see your System Administrator if you do not know the servername.)

1. Open the FME Desktop Licensing Assistant by clicking Start > Pro-grams > FME Desktop > Utilities > FME Licensing Assistant.

2. Select Connect to a floating license server. In the Server Namefield, enter the name of the floating license server.

3. Click Next.

4. Select the license type from the list, and click Activate.



5. Click Finish.

You will see a message when you are successfully connected to thefloating license server.

To borrow the license for offline use, you will have to start FMEWorkbench and specify the terms of the license. See "Specify theTerms of the License" below.

6.2 Specify the Terms of the License

To access the License Borrowing option, start FME Workbench:

1. Click Start > Programs > FME Desktop > FME Workbench.

2. Click Tools > License Borrowing.

3. Click Yes, borrow a license for, and then enter or adjust the numberof days. Click OK to close the dialog.

4. Click OK.

You have successfully borrowed the floating license for the spe-cified number of days.

To run FME Desktop during this time frame, you do not need to be con-nected to the license server.

6.3 Return the License

To return a borrowed license before the time expires:

1. Start Workbench.

2. Click Tools > License Borrowing.

3. On the License Borrowing pane, select Yes, return the borrowedlicense early. Click OK.



4. Click OK.

The license is now available for other FME Desktop users to borrow.

Note: You cannot change or update licenses when you haveborrowed a floating license. You need to return a bor-rowed license first.

7 Installing FME Desktop on Linux and UNIXAll installation steps must be performed under the same user account.Please read this section carefully in order to determine under which useraccount to install FME Desktop on your system.

The following installers are available for various UNIX systems:

Platform Installer Name

Linux fme-engine-linux-2013-x64.run (no GUI)

Linux fme-desktop-linux-2013-x64.run (no FME Workbench)

Note: Ensure that your system meets all the requirements. See"Linux and UNIX System Requirements" on page 2.

7.1 Installing FME Desktop on Linux

1. Download FME Desktop Installer to your local machine.

Note: You can download the installer for FME Desktop Linuxx64 Edition from: http://www.safe.-com/support/downloads.php. For other FME DesktopUNIX editions, please contact [email protected]

2. Choose the user account under which FME Desktop will be installed.The installer can be run by a regular user or "as root" (via the sudocommand on some distributions).

n If you run the installer as a regular (non-root) user:

n FME Desktop is installed for the current user ONLY.

n The default install location is $HOME/fme.

27


n If you run the installer as root (or via sudo):

n FME Desktop is installed for ALL users

n The default install location is /opt/fme.

3. Run the installer using the following command:

As regular (non-root) user:

./<installer_filename>

Example:./fme-desktop-b13214-linux-x64.run

As root:

./<installer_filename> -- OVERRIDE_ROOT=Yes

(Note that -- is its own argument.)

Example:./fme-desktop-b13214-linux-x64.run -- OVERRIDE_ROOT-T=Yes

Alternatively, you can install FME Desktop by double-clicking theinstaller.

Note: Before running the installer, please ensure that theinstaller has “execute” permission. Use one of fol-lowing methods:

n Right-click on the executable and select Prop-erties > Permission > Check, or

n chmod u+x ./fmefull-linux.run

4. Select the location to install FME Desktop.

./opt/fme :

Before installation proceeds, you are prompted to accept orchange some defaults:

7 Installing FME Desktop on Linux and UNIX

28

7.1 Installing FME Desktop on Linux

Do you wish to associate format file types with FME?[No] : YesWill you be performing Nad83/Nad27 Datum shifts inCanada?[No] : YesWould you like to install the FME Software Devel-opment Kit?[No] : Yes

Note: The default selection is shown in brackets.

Once the installation is complete, the installer will generate a con-figuration file:

opt/fme/install.cfg

To perform this installation automatically, run the installer from thecommand line.

29

30

8 Installing Single-Fixed Licenses on Linux and UNIX


Your serial number is printed on your welcome letter and your invoice. Ifyou do not know or cannot find your serial number, please send an e-mailto [email protected] to request a license file.

To activate your license, you will need an Internet connection.

Note: Fixed licenses do not work with virtual machines that arebuilt and moved around among many physical machines.Installing FME on a virtual machine requires a floatinglicense. For further details, please refer to "Installing Float-ing Licenses on Linux and UNIX" on page 37.

8.2 Installing Single-Fixed Licenses on Linux

A single-fixed FME license enables FME to work on a single specified com-puter. If more than one user installs FME, each user has to install a fixedlicense on their computer.

Note: If you change your system's hardware configuration afterinstallation, your FME license may not work and you willneed to request a new one.

1. Once FME Desktop is installed on Linux, log in as the same user whoinstalled FME Desktop.

2. Navigate to Application > FME Desktop > Utilities > FME LicensingAssistant.

3. The FME Desktop Licensing Assistant opens.

4. Click Activate a single-fixed license. Enter the Serial Number in thecorresponding field and click Activate.

31

5. Click Finish.

You will see a confirmation message when FME Desktop is suc-cessfully licensed.

8.2.1 Installing a License File Provided by Safe Software

Follow the steps below if you have a problem with the automated licensegenerator. If this happens, you will need to install a license file(*.fmelic) provided by Safe Software.

If you already have the license file, active a single-fixed license by fol-lowing these steps:

1. Send an e-mail message to [email protected] with the following:

n serial number

n your 10-digit registration key, which is located at the bottom leftcorner of the install pane of the FME Desktop Licensing Assistant:


32

8.2 Installing Single-Fixed Licenses on Linux

Note that the number shown here is an example only.

You will receive an e-mail message from Safe Software with an attached.fmelic license file. Note for Linux users: Once FME Desktop isinstalled, log in as the same user who installed FME Desktop.

1. Navigate to FME Desktop > Utilities > FME Licensing Assistant (onWindows, this is in the Start menu). The FME Desktop LicensingAssistant opens.

2. Click Install a license file provided by Safe Software.

3. Browse to the location of your license file and click Activate.

33

4. Click Finish.

FME Desktop is successfully licensed.

Note: Licenses are tied to physical properties of systems. If youchange your system's hardware configuration, your FMElicense may not work and you will need to request a newone.

8.3 Installing Single-Fixed Licenses on UNIX

1. Ensure your working directory is the installation directory, andthen run the runfme program (with no arguments) to obtain theregistration number:

./runfme

Unless there is licensing information already present in this loc-ation, you receive an error message that includes the computerregistration number:

FME license system failure. Contact your Dis-tributor. Your machine key is 1-234-567-890.

Write down the 10-digit number and send an e-mail message [email protected]. Include your operating system type and versionnumber; for example, Linux Intel x64. We will send you an.fmelic license file.

To register this license from the install directory, run this com-mand:

runfme <licensefilebaseName.fmelic>

Note: Remember that you must register FME as the sameuser who untarred the installation file.

2. The easiest way to run FME is to use the runfme script. This scriptsets the FME_HOME and LD_LIBRARY_PATH (or LIBPATH or SHLIB_PATH, depending on the platform) environment variables, and thenruns FME.


34

8.3 Installing Single-Fixed Licenses on UNIX

For best results, store the runfme script in the same directory asthe FME and its other support files.

If the FME installation directory is in the user's path, you can runthe runfme script as follows:

runfme <normal FME arguments>

If the script is moved out of the FME installation directory, it mustbe updated so that the default value of FME_HOME points to theinstallation directory.

3. All users who want to access FME without using the runfme scriptmust have their environments set up correctly.

This is normally done by adjusting each user’s login script to set theFME_HOME environment variable, and adding FME_HOME/fme coreinto thePATH and LD_LIBRARY_PATH environment variables.

The way to make this change depends on your configuration andwhich UNIX shell you use; however, if you use the C-Shell, you canset 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 oneplace so they can be accessed by all users.

Alternatively, you can edit the runfme script in the FME installationdirectory. The script’s header comments outline the required modi-fications.

8.3.1 Updating the FME Version

If you’re updating to a newer version of FME, follow these steps:

1. Copy the .fmelic license file from your existing FME installation dir-ectory to a safe place.

35

2. After you have installed the new FME version, copy the .fmeliclicense file to your new FME installation directory.

3. If you installed in a different directory, adjust your PATH and LD_LIBRARY_PATH to the new directory.

4. Start FME.

Note: You can store multiple versions of FME for UNIX; how-ever, Safe Software recommends that you keep only oneversion active.


36

9 Installing Floating Licenses on Linux and UNIXA floating license enables a number of concurrent users to simultaneouslyaccess a single FME deployment. FLEXlm technology provides the floatinglicense capability to FME. For a full description, visit Flexera Software’swebsite:

http://www.flexera.com

The FLEXlm software is installed on a computer that acts as a licenseserver by issuing a license to any client computer that requests one. Ifthe number of user requests exceeds the number of floating licenses pur-chased, a user will need to wait until one of the active FME users closesFME on their computer so that the FME license is returned to the licenseserver.

This chapter covers among other topics:

n Preparing for a New Floating License

n Installing a New Floating License

n Configuring FME Desktop to Use a Floating License


n You must be running a TCP/IP network.

n One computer on the network is designated as the license server.The license server may be any computer on the network that is vis-ible to all computers that are dependent on it for their licenses. Youshould choose a computer that is always running and always con-nected to the network because the client computers must be able tocommunicate with the license server to use the FME. The pro-cessing burden on the licensing server is negligible.

n You must have Administrator privileges to install the FME FloatingLicense server.

37

http://www.flexera.com/

n If the computer you want to use as your floating license serverhas a firewall, you must open a port through which the FlexServercan communicate. By default, the range of ports used is 27000-27009, although you can also configure other ports.

9.2 Locating the FLEXlm License Server Files

Please read and understand the following steps before attempting to useFLEXlm licensing on Linux x64.

If you have purchased an FME floating or single-fixed license for UNIX,copy the Linux\FlexServer directories from the FME installation disk,or go to Safe Software’s FTP site and save the following file:

n ftp://ftp.safe.com/fme/floatingLicense/FlexServer11_8-linux-x64.tar.gz

This directory contains the lmutil and lmgrd files that you’ll need to setup a FLEXlm server on UNIX, and it contains the FLEXlm license serversoftware. You should install this software on your license server com-puter, which is the computer that will manage the licenses.

Note: Current versions of lmgrd license manager and lmutilend user utilities are also available from Flexera Soft-ware.

9.3 Preparing for a New Floating License

There are several things you must do to prepare to install a new floatinglicense, each of which is described here.

9.3.1 Creating a Directory for the FLEXlm License Server

You need to create a directory for the FLEXlm license server and extractthe contents of flexServer11_8-linux-x64.tar.gz into this directory.For example:

% mkdir /opt/FlexServer% cd /opt/FlexServer% gunzip < ~/flexServer11_8-linux-x64.tar.gz | tar xf -

9 Installing Floating Licenses on Linux and UNIX

38

http://learn.flexerasoftware.com/content/ELO-LMGRD

9.3 Preparing for a New Floating License

This directory is referred to as the FlexServer directory for the remainderof these instructions.

9.3.2 Providing the Information to Generate a Floating License

Safe Software requires three pieces of information to generate a floatingor node-locked license:

n hostname

n host ID

n FME serial number

9.3.2.1 Obtaining the Hostname

To obtain the hostname, type the hostname command. For example:

% hostnameworf

In this example, the host name is worf.

9.3.2.2 Determining the Host ID

To determine the host ID, use the lmutil lmhostid command withinthe FlexServer directory. The output should be an eight-character alpha-numeric string (or a 12-character alphanumeric string on Linux). Forexample:

% ./lmutil lmhostidlmutil - Copyright (c) 1989-2009The FLEXlm host ID of this machine is "807abc12"

In this example, the host ID is 807abc12.

Note: When you are running ./lmutil lmhostid, you may see the fol-lowing error message:

>-bash: ./lmutil: No such file or directory

This error appears when FLEXlm is missing necessary libraries to run onLinux. To clear the error, install lsb-core by typing the command:

sudo apt-get install lsb-core

39

9.3.2.3 Determining the FME Serial Number

To determine the serial number, look at your welcome letter or yourinvoice.

Send an e-mail message to [email protected] 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 thelicense code server.

Copy the safe.lic file into the FlexServer directory on your licenseserver computer.

Note: The filename must remain in lowercase text. Safe Soft-ware recommends that you do not change the filename. Ifyou want to change the file contents (for example, changea port number), please refer to the FLEXlm User’s Guide,available on your FME installation disk.

9.4 Installing a New Floating License

Note: To start the Flex Server, you must have a /usr/tmp dir-ectory.

Verify that the /usr/tmp directory exists and if it doesn’texist, 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 ter-minal. 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, sothere is no need to explicitly background the application. However,you’ll have to start the server each time the license server host is


40

9.5 Configuring FME Desktop to Use a Floating License

rebooted. The system administrator can make sure the preceding com-mand is run at system start-up time.


To configure an installation of FME to use a particular license server, fol-low these steps.

9.5.1 Configuring FME Desktop on Linux

1. Once FME Desktop is installed on Linux, log in as the same user whoinstalled FME Desktop.

2. Navigate to Applications > FME Desktop > Utilities > FME LicensingAssistant. The FME Licensing Assistant opens.

3. On the FME Licensing Assistant, select Connect to a floating licenseserver button.

4. In the Server Name field, enter the name of the license server.Click Next.

5. Select the FME Edition from the list and click Activate.

41

6. Click Finish.

A floating license is installed to borrow a license.


42


9.5.2 Configuring FME Desktop on UNIX

To configure an installation of FME Desktop on UNIX to use, create a textfile called fme_license.dat in the FME license directory. The licenseserver may or may not be the host where FME Desktop is installed, andcould even be a Windows host that is already running floating licenses.

Note: Any examples shown here are simple configurations basedon default port numbers. However, FLEXlm lets you set upother configurations, as well as specify locations for thelicense server through environment variables. If you wantto do this, please skip the steps that follow and refer todetailed instructions in the FLEXlm User’s Guide.

The safe.lic file we provide when you’re preparing to install a floatinglicense is used to configure the floating license server. It is necessary foreach FME installation to have a separate fme_license.dat file that tellsFME which computer to connect with when looking for license information.

1. Remove existing license files.

2. Make sure that the FME installation directory is cleared of any filesnamed fme_license.dat and fme_license.fmelic.

3. Create a file that contains the following information:

SERVER <ServerHostName> AnyUSE_SERVER

In a few of the previous examples, the server was installed onto ahost named worf on a local network, using the default port number.The following command uses this example to create the neededlicense file.

% cd /opt/fme% cat > fme_license.datSERVER worf AnyUSE_SERVER<Ctrl+d>

(Typing Ctrl+d ends the input to fme_license.dat.)

43

9.6 Installing a Permanent Three-Server Redundant FloatingLicense Server

FLEXlm allows for redundancy by using a set of three license servers.With three-server redundancy, the floating license server stays func-tional, handing out its total complement of licenses when any two of thethree license servers are up and running.

A master server that performs all licensing operations is elected whenthe redundant servers are started. The other two servers are there toprovide a secure licensing mechanism in the event of hardware failureor if the master node needs to be rebooted.

It is not a requirement for each of the server nodes to have the samearchitecture or operating system, although they should have reliable net-work communications with each other and should be on the same sub-net. Often, this means that the three servers are located physicallyclose to each other.

If you have any questions about this topic, send an e-mail message withyour questions to [email protected].

9.6.1 Download and Run the Installer

Install the floating license server on three different computers using theinstructions in sections "Before You Begin" on page 37 through"Installing a New Floating License" on page 40.

Send an e-mail to [email protected] and include the FLEXlm Host ID, thehostname assigned to each of the computers. (The serial number is prin-ted on your welcome letter and on your invoice.)

We will e-mail you a file called safe.lic that contains the key code filefor the license code servers. Copy the safe.lic file into each of theFlexServer directories on your license server nodes.

9.6.2 Start the License Servers

Start the license manager on all three servers, in order based on the fol-lowing:


44

9.6 Installing a Permanent Three-Server Redundant Floating

The first server started of the first two servers 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 27009SERVER host2 9384749 27009SERVER host3 2038404 27009VENDOR safeFEATURE FME . . .. . .

Therefore, the first server to start—host1—becomes the master node;host3 never becomes the master node.

There is no time limit for starting all of the servers.

Unlike independent servers, each SERVER line requires a port number.The port number in this example is 27009. You can modify the port num-bers to any unused port number in the range 1024 to 32000.

You can change the order of the SERVER lines to suggest which node is themaster node, however we recommend you keep the order shown in thepreceding example.

To start the license server:

% <FlexServerDir>/lmgrd -c <FLEXServerDir>/safe.lic

This action runs the server in the foreground, logging activity to the ter-minal. 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 thereis no need to explicitly background the application. However, you’ll haveto start the server each time the license server host is rebooted. The sys-tem administrator can make sure the preceding command is run at sys-tem start-up time.

45

9.6.3 Run the FME Licensing Assistant and Connect to the FirstServer

For instructions, see "Configuring FME Desktop to Use a FloatingLicense" on page 41.

9.7 Starting FME from the Command Line

For information on using FME from the command line, please see theFME Fundamentals manual, available at:

http://www.safe.com/support/onlinelearning/documentation.php


46

http://www.safe.com/support/onlinelearning/documentation.php

Installing Grid Shift Files on Microsoft Windows

10 Installing Grid Shift Files on Microsoft WindowsFME supports conversions between coordinate systems using differentdatums. Many datum transformations are not mathematically definableand require the use of grid of shifts. If you attempt to perform a datumtransformation 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 SafeSoftware are automatically installed in the correct location.

If you have already installed FME, you can find more information onwhich files are included by opening Workbench help and clicking on theCoordinate Systems topic, or by choosing Tools > Browse Coordinate Sys-tems 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 gridshift files.

Installing Grid Shift Files on Linux or UNIX

11 Installing Grid Shift Files on Linux or UNIXWhen you install FME for Linux/UNIX, the grid shift files provided by SafeSoftware are automatically installed in the correct locations.

You can find more information on which files are included in Linux andUNIX 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 folderinclude a path to the location of your grid file. The order in which the gridsare listed is the order in which FME uses them.

To register a file, add the full pathname of the file to the beginning of theappropriate .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 whenyou 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 Systemsicon.

12 Using FME Desktop with Third-Party ApplicationsFME Desktop integrates with a number of popular GIS applications. Visitwww.safe.com for more information.

This chapter provides instructions for using the FME Integration Consoleto extend any applicable third-party applications.

12.1 FME Integration Console

The FME Integration Console detects any supported third-party applic-ations that are already installed on your system. When you install a newFME license using the FME Licensing Assistant, the FME Integration Con-sole attempts to extend all installed third-party applications that are sup-ported by the FME license.

To open the FME Integration Console, click Start > FME Desktop > Util-ities > FME Integration Console.

FME will scan your machine for extended applications and show the res-ults in the log pane. If your machine contains any installed applicationsthat can be extended to support FME, they will be listed in the Applicationcolumn.

Note: FME cannot extend shared applications that are installed ona different machine. FME and the application to be exten-ded must be installed on the same logical machine, regard-less of whether it is a physical or virtual machine.

If you click on the name of the application, the Properties area will dis-play the details:

Property Value

Application The name of the application

Status The FME build number that extends the application.

The build number will change each time you update FME.

51

Property Value

Extendable Is this application extendable by FME? A Yes in this columnindicates that the application is ready to be extended.

Extended Is this application extended by FME? If No, then you canextend the application from the Action column.

FME Build The current FME build installed on your machine.

FME HomePath

The location of the FME installation folder.

Buttons

Copy Text Copies the properties so you can paste details into an e-mail program or text file. This information might berequired if you need to troubleshoot an installation.

Options This button is enabled only when some third-party applic-ations are installed. When enabled, it allows you to setapplication-specific top-level defaults.

Menus

The File and View menus contain basic window-level commands thatallow you close the application or adjust the visible areas.

Through the Help menu, you can view the current FME build number andcheck for FME updates.

12.1.1 Reverting and Extending Applications

If the Status of an application is Not Extended, the Action column willcontain an Extend button. Press the button to extend the application toan Extended state. The log pane will display information.

If the Status of an application is Extended, the Action column will con-tain a Revert button. Press the button to revert the application to a NotExtended state. The log pane will display information.

12 Using FME Desktop with Third-Party Applications

52

Documents

FME DesktopInstallationandLicensingManual FME ...docs.safe.com/fme/2013sp2/pdf/FMEInstallationLicensing_print.pdf · FME DesktopInstallationandLicensingManual – FME DesktopVersion2013SP2