FME Desktop InstallationandLicensingManual - Safe …docs.safe.com/fme/2013/pdf/FMEInstallationLicensing.pdfFME Server,offeredatarangeofskilllevels.Youcanchoosehowyou wanttolearn:in-person,on-lineinstructor-led,orwithself-paced

FME® DesktopInstallation and Licensing Manual

ii FME Installation and Licensing Manual

E-mail: [email protected] • Web: www.safe.com

FME Installation and Licensing Manual iii

Safe Software Inc. makes no warranty either expressed or implied, including, but not lim-ited to, any implied warranties of merchantability or fitness for a particular purposeregarding 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, orconsequential damages in connection with or arising out of purchase or use of these mate-rials. The sole and exclusive liability of Safe Software Inc., regardless of the form oraction, 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 changewithout 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 and would appreciate being informed ofany errors found. Safe Software Inc. will correct any such errors and omissions in a sub-sequent version, as feasible. Please contact us at:

Safe Software Inc.Suite 2017, 7445 – 132nd StreetSurrey, BCCanadaV3W 1J8

www.safe.com

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

Trademarks

FME is a registered trademark of Safe Software Inc.

All brands and their product names mentioned herein may be trademarks or registeredtrademarks of their respective holders and should be noted as such.

Document Information

Document Name: FME Installation and Licensing ManualVersion: FME Desktop 2013Updated: September 2012

iv FME Installation and Licensing Manual

http://www.safe.com/

Contents

1 Getting Started 1

1.1 Before You Begin 11.2 Supported Platforms 11.3 Minimum System Specifications 21.4 Linux and UNIX System Requirements 21.5 Determining the FME License Type to Install 2

1.5.1 Single-Fixed License 31.5.2 Floating License 3

1.6 FME Community 31.6.1 FMEpedia 41.6.2 FME User Central 41.6.3 FME Training 4

2 Installing FME Desktop on Microsoft Windows 5

2.1 Installing FME Desktop 52.1.1 Updating to a Newer FME Version 5

3 Installing Single-Fixed Licenses 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 Floating Licenses on Microsoft Windows 11

4.1 Installing a Floating License 114.1.1 Before You Begin 114.1.2 Download and Run the Installer 124.1.3 Request and Install the License 134.1.4 Install FME on Client Computers 144.1.5 Start FME Registration 14

4.2 Installing a Permanent Three-Server Redundant Floating LicenseServer 15

4.2.1 Download and Run the Installer 164.2.2 Start the License Servers 174.2.3 Install FME on Client Computers 18

4.3 Borrowing a License 194.3.1 Connect to the Floating License Server 194.3.2 Specify the Terms of the License 214.3.3 Return the License 22

5 Installing FME Desktop on Linux and UNIX 25

5.1 Installing FME Desktop on Linux 25

FME Installation and Licensing Manual v

6 Installing Single-Fixed Licenses on Linux and UNIX 29

6.1 Before You Begin 296.2 Installing Single-Fixed Licenses on Linux 29

6.2.1 Installing a License File Provided by Safe Software 306.3 Installing Single-Fixed Licenses on UNIX 32

6.3.1 Updating the FME Version 33

7 Installing Floating Licenses on Linux and UNIX 35

7.1 Before You Begin 357.2 Locating the FLEXlm License Server Files 367.3 Preparing for a New Floating License 36

7.3.1 Creating a Directory for the FLEXlm License Server 367.3.2 Providing the Information to Generate a Floating License 37

7.4 Installing a New Floating License 387.5 Configuring FME Desktop to Use a Floating License 39

7.5.1 Configuring FME Desktop on Linux 397.5.2 Configuring FME Desktop on UNIX 41

7.6 Installing a Permanent Three-Server Redundant Floating LicenseServer 42

7.6.1 Download and Run the Installer 427.6.2 Start the License Servers 427.6.3 Run the FME Licensing Assistant and Connect to the FirstServer 43

7.7 Starting FME from the Command Line 44

8 Installing Grid Shift Files 45

8.1 Installing Grid Shift Files on Microsoft Windows 458.2 Installing Grid Shift Files on Linux or UNIX 45

9 Using FME Desktop with Third-Party Applications 47

9.1 FME Integration Console 479.1.1 Reverting and Extending Applications 48

vi FME Installation and Licensing Manual

About_Installing_FME_Server

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

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






1 Getting StartedThis manual contains procedures for:

n FME Desktop installation on Microsoft®Windows®, UNIX®, and Linux®

n FME Desktop and FME Server licensing

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 Supported Platforms

Windows 32-bit

n Windows 8

n Windows 7

n Windows Vista

n Windows 2008 Server

n Windows 2003 Server

n Windows XP SP1

Windows 64-bit

n Windows 8

n Windows 7

n Windows Vista

n Windows 2008 Server (with the win64 platform)

FME Installation and Licensing Manual 1

All 64-bit Windows editions listed above also support 32-bit FME. Pleasesee the Guide for Running 64-bit FME for details on differences between32-bit and 64-bit FME.

1.3 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 1 GB of RAM

n 1.5 GB of available hard-disk space

n To install FME on a server for use with a thin-end client (for example, a Cit-rix® installation), you need to use FME floating licenses

n To install floating licenses, you must be running a TCP/IP network.

1.4 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)

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

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 Getting Started

2 FME Installation and Licensing Manual

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






1.6 FME Community

1.5.1 Single-Fixed License

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

n 6.2.

n 6.3.

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.

n 4.1

n 7

1.6 FME Community

Our online community consists of an enthusiastic group of users and SafeSoftware staff who participate in various online resources. These tech-nical resources are a forum where FME users ask questions, receive help,and exchange information on FME products. We welcome and encouragequestions about FME formats, processing capabilities, future plans, doc-umentation, FME Objects, mapping files, and coordinate conversionissues.



1.6.1 FMEpedia

FMEpedia is Safe Software's user collaboration site. Based on Medi-awiki, FMEpedia is maintained both by Safe Software staff and membersof the FME community.

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

1.6.2 FME User Central

The FME User Central page is the access point that lets you quicklysource various technical resources, and the latest news and technicalbulletins.

To access these resources, visit http://safe.com/support/fme-user-cen-tral-community/.

1.6.3 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/.

1 Getting Started


http://www.fmepedia.com/

http://safe.com/support/fme-user-central-community/






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

2 Installing FME Desktop on Microsoft Windows

2.1 Installing FME Desktop

If 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.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 that you havesaved in your FME installation directory.

1. Insert the installation disk into the DVD drive. If the autorun feature is ena-bled on your computer, FME starts the installation process. If not, browse tothe DVD drive and double-click autorun.exe.

2. If the installation wizard finds a previously installed version of FME, it asks ifyou would like to uninstall it. If you answer yes, you can proceed to step 4.

If you did not select to uninstall the previous version of your FMEsoftware, use the Add/Remove Programs option on the ControlPanel to uninstall any previous versions of FME. You should nothave more than one version of FME on your computer.

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

4. Follow the instructions in the installation wizard.



3 Installing Single-Fixed Licenses 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 are built andmoved around amongmany physical machines. Installing FME on avirtual machine requires a floating license. For further details,please refer to 7.4.

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 be prompted toupdate 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 in the cor-responding field, and click Activate.


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 4.1.

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 6.2.1.

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 (*.f-melic) provided by Safe Software.

3 Installing Single-Fixed Licenses on Microsoft Windows


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



3.2 Activating a Single-Fixed License

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 left corner ofthe install pane:

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 (on Windows,this is in the Start menu). The FME Desktop Licensing Assistant opens.

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

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


4. Click Finish.

FME Desktop is successfully licensed.

Note: Licenses are tied to physical properties of systems. If you changeyour system's hardware configuration, your FME license may notwork and you will need to request a new one.

3 Installing Single-Fixed Licenses on Microsoft Windows


4 Installing Floating Licenses on Microsoft Windows

4.1 Installing a Floating License

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 floating licenses with dif-ferent 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.

4.1.1 Before You Begin

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 license server. Thelicense server can be any computer on the network that is visible to all com-puters that are dependent on it for their licenses. Select a computer that isalways running and always connected to the network, because the clientcomputers must be able to communicate with the license server to use FME.The processing load on the licensing server is negligible.

n You must have administrator privileges to install the FME floating licenseserver.


n If the computer you want to use as your floating license server has a fire-wall, you must open a range of ports through which the FlexServer cancommunicate.

n If FLEXlm is already installed on your license server, you still need to per-form a new installation. FME 2011 requires the version of FLEXlm that isincluded in the installer. In addition, if your organization is configuringlicense borrowing (see 4.3), you will require LMTOOLS version 11.8 ornewer.

Note: The FME license server cannot be installed on a virtual machinethat is built andmoved around amongmany physical machines.It must be locked to a single fixedMAC address.

4.1.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 [email protected].

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

License AdministrationGuide

Opens Flexera Software’s LicenseAdministration Guide.



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

4.1 Installing a Floating License


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 license man-ager and lmutil end user utilities, available from the Down-loads area of www.flexera.com. The other files are requiredfor new FME installations only.

4.1.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 open the hos-tid.txt file.

Note: If you’re installing FLEXlm on Windows Vista, you need toright-click Start-Restart FME License Server and run thisfunction using administrator privileges.

2. Copy and paste the contents of hostid.txt file to an e-mail. Include yourFME serial number and name, and send it to [email protected].

The serial number is printed on your welcome letter and on yourinvoice. Safe Software will send you the license file.

3. When you receive the safe.lic file, copy it into the FlexServer directory;for example, c:\program files\FlexServer\.


4. Go to Start > Programs > Safe Software, and choose Start - Restart FMELicense Server.

4.1.4 Install FME on Client Computers

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

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

4.1.5 Start FME Registration

Perform this step for each computer that has FME installed.

1. To open the FME Licensing Assistant, click Start > Programs > FME Desk-top > Utilities > FME Licensing Assistant.



4.2 Installing a Permanent Three-Server Redundant Floating License Server

2. Select Connect to a floating license server, and enter the name of the com-puter that is hosting the FME licenses.

3. Click the Next button.

4. If your floating license allows for more than one type of FME license, selectthe license that you want to use.

5. Click Finish to complete the connection.

4.2 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 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 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].


The FME installation disk contains the utility program that is needed toget the 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 Acrobat security set-tings may prevent access to the installer. You can paste theabove link into a web browser.

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

http://d-ownloads.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 Soft-ware program group:


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

Launch LMTOOLS Launches LMTOOLS. Used for debuggingor changing configuration.

License Administration Guide Opens Flexera Software’s License



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






Administration 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 isprinted 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 the Flex-Server directories on your license server nodes.

4.2.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-click Start-Restart FME License Server and run this function using admin-istrator 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 27009


VENDOR 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 portnumbers to any unused port number in the range 1024 to 32000.

You can change the order of the SERVER lines to suggest which node isthe master node, however we recommend you keep the order shown inthe preceding example.

4.2.3 Install FME on Client Computers

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 fromfixed license to floating), ensure that there are no existing fme_license.dat or fme_license.fmelic files in the C:\ProgramFiles\FME\licenses directory.

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 tostart 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.



4.3 Borrowing a License


If 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 version 11.8 ornewer.

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 consultyour 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 4.3.3.

4.3.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 > Programs >FME Desktop> Utilities > FME Licensing Assistant.

2. Select Connect to a floating license server. In the Server Name field, enterthe 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 4.3.2.

4.3.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 number of days.Click OK to close the dialog.

4. Click OK.


You have successfully borrowed the floating license for the spec-ified number of days.

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

4.3.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 borrowed licenseearly. 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 have bor-rowed a floating license. You need to return a borrowedlicense first.



5 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

Solaris fme-engine-2012-solaris-sparc64.run (no GUI)

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

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

Note: Ensure that your system meets all the requirements. See 1.4.

5.1 Installing FME Desktop on Linux

1. Download FME Desktop Installer to your local machine.

Note: You can download the installer for FME Desktop Linux x64Edition from: http://www.safe.co-m/support/downloads.php. For other FME Desktop UNIXeditions, please contact [email protected]

2. Choose the user account under which FME Desktopwill be installed. Theinstaller can be run by a regular user or "as root" (via the sudo command onsome 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.





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:

./fme-desktop-linux-x64.run

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 followingmethods:

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

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

4. Select the location to install FME Desktop.

./opt/fme :

Before installation proceeds, ou will be prompted to accept orchange some defaults:

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

5 Installing FME Desktop on Linux and UNIX


5.1 Installing FME Desktop on Linux

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



6 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 are built andmoved around amongmany physical machines. Installing FME on avirtual machine requires a floating license. For further details,please refer to 7.

6.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 after instal-lation, your FME license may not work and you will need to requesta new one.

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

2. Navigate to Application > FME Desktop> Utilities > FME Licensing Assistant.

3. The FME Desktop Licensing Assistant opens.

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


5. Click Finish.

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

6.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 (*.f-melic) 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 left corner ofthe install pane:



6.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 (on Windows,this is in the Start menu). The FME Desktop Licensing Assistant opens.

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

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

4. Click Finish.

FME Desktop is successfully licensed.


Note: Licenses are tied to physical properties of systems. If you changeyour system's hardware configuration, your FME license may notwork and you will need to request a new one.

6.3 Installing Single-Fixed Licenses on UNIX

1. Ensure your working directory is the installation directory, and then runthe runfme program (with no arguments) to obtain the registrationnumber:

./runfme

Unless there is licensing information already present in this loca-tion, you receive an error message that includes the computer reg-istration 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 .fm-elic 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 same userwho untarred the installation file.

2. The easiest way to run FME is to use the runfme script. This script sets theFME_HOME and LD_LIBRARY_PATH (or LIBPATH or SHLIB_PATH, depend-ing on the platform) environment variables, and then runs FME.

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>



6.3 Installing Single-Fixed Licenses on UNIX

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

3. All users who want to access FME without using the runfme script must havetheir 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 mod-ifications.

6.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 directory toa safe place.

2. After you have installed the new FME version, copy the .fmelic license fileto 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; however, SafeSoftware recommends that you keep only one version active.



7 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 7.3

n 7.4

n 7.5


n You must be running a TCP/IP network.

n One computer on the network is designated as the license server. The licenseserver may be any computer on the network that is visible to all computersthat are dependent on it for their licenses. You should choose a computerthat is always running and always connected to the network because theclient computers must be able to communicate with the license server to usethe FME. The processing burden on the licensing server is negligible.

n You must have Administrator privileges to install the FME Floating Licenseserver.

n 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


http://www.flexera.com/

default, the range of ports used is 27000-27009, although you can alsoconfigure other ports.

7.2 Locating the FLEXlm License Server Files

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

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

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

n ftp://ftp.safe.com/fme/floatingLicense/FlexServer11_8-solaris-sparc64.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 lmutil end userutilities are also available from the Downloads area of www.fle-xera.com.

7.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.

7.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-solaris-sparc64.tar.gz or flex-Server11_8-linux-x64.tar.gz into this directory. For example:

% mkdir /opt/FlexServer% cd /opt/FlexServer

7 Installing Floating Licenses on Linux and UNIX


7.3 Preparing for a New Floating License

% gunzip < ~/flexserver11_8-solaris-sparc64.tar.gz | tarxf -

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

7.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

7.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.

7.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

7.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 filenamemust remain in lowercase text. Safe Software rec-ommends that you do not change the filename. If you want tochange the file contents (for example, change a port number),please refer to the FLEXlm User’s Guide, available on your FMEinstallation disk.

7.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 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



7.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.

7.5.1 Configuring FME Desktop on Linux

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

2. Navigate to Applications > FME Desktop> Utilities > FME Licensing Assis-tant. The FME Licensing Assistant opens.

3. On the FME Licensing Assistant, select Connect to a floating license serverbutton.

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.


6. Click Finish.

A floating license is installed to borrow a license.




7.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 based ondefault port numbers. However, FLEXlm lets you set up other con-figurations, as well as specify locations for the license serverthrough environment variables. If you want to do this, please skipthe steps that follow and refer to detailed instructions in theFLEXlm 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 files namedfme_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.)


7.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].


Install the floating license server on three different computers using theinstructions in sections 7.1 through 7.4.

Send an e-mail to [email protected] and include the FLEXlm Host ID, thehostname assigned to each of the computers. (The serial number isprinted 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.

7.6.2 Start the License Servers

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




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 portnumbers 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.

7.6.3 Run the FME Licensing Assistant and Connect to the FirstServer

For instructions, see 7.5.


7.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



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

8 Installing Grid Shift Files

8.1 Installing Grid Shift Files on Microsoft Windows

FME 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 > Coor-dinate Systems.

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

8.2 Installing Grid Shift Files on Linux or UNIX

When 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 ofthe 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 whenyou run a translation.

Note: If you have access to the FME Workbench user interface, you canmanage grid shift files through the Workbench > Tools > FMEOptions menu. Click the Coordinate Systems icon.

8 Installing Grid Shift Files


9 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.

9.1 FME Integration Console

The FME Integration Console detects any supported third-party appli-cations 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 theresults 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 on a dif-ferent machine. FME and the application to be extendedmust beinstalled on the same logical machine, regardless of whether it is aphysical 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.


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 appli-cations 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.

9.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.

9 Using FME Desktop with Third-Party Applications


Documents

FME Desktop InstallationandLicensingManual - Safe …docs.safe.com/fme/2013/pdf/FMEInstallationLicensing.pdfFME Server,offeredatarangeofskilllevels.Youcanchoosehowyou wanttolearn:in-person,on-lineinstructor-led,orwithself-paced