FME Desktop Installation and Licensing Manual

Transcription

1 FME Desktop Installation and Licensing Manual

2 ii FME Installation and Licensing Manual

3 Web: FME Installation and Licensing Manual iii

4 Safe Software Inc. makes no warranty either expressed or implied, including, but not limited to, any implied warranties of merchantability or fitness for a particular purpose regarding these materials, and makes such materials available solely on an as-is basis. In no event shall Safe Software Inc. be liable to anyone for special, collateral, incidental, or consequential damages in connection with or arising out of purchase or use of these materials. The sole and exclusive liability of Safe Software Inc., regardless of the form or action, shall not exceed the purchase price of the materials described herein. This manual describes the functionality and use of the software at the time of publication. The software described herein, and the descriptions themselves, are subject to change without notice. Copyright Safe Software Inc. All rights are reserved. Revisions Every effort has been made to ensure the accuracy of this document. Safe Software Inc. regrets any errors and omissions that may occur and would appreciate being informed of any errors found. Safe Software Inc. will correct any such errors and omissions in a subsequent version, as feasible. Please contact us at: Safe Software Inc. Suite 2017, nd Street Surrey, BC Canada V3W 1J8 Safe Software Inc. assumes no responsibility for any errors in this document or their consequences, and reserves the right to make improvements and changes to this document without notice. Trademarks FME is a registered trademark of Safe Software Inc. All brands and their product names mentioned herein may be trademarks or registered trademarks of their respective holders and should be noted as such. Document Information Document Name: FME Installation and Licensing Manual Version: FME Desktop 2013 Updated: September 2012 iv FME Installation and Licensing Manual

5 Contents 1 Getting Started Before You Begin Supported Platforms Minimum System Specifications Linux and UNIX System Requirements Determining the FME License Type to Install Single-Fixed License Floating License FME Community FMEpedia FME User Central FME Training 4 2 Installing FME Desktop on Microsoft Windows Installing FME Desktop Updating to a Newer FME Version 5 3 Installing Single-Fixed Licenses on Microsoft Windows Before You Begin Activating a Single-Fixed License Installing a License File Provided by Safe Software 8 4 Installing Floating Licenses on Microsoft Windows Installing a Floating License Before You Begin Download and Run the Installer Request and Install the License Install FME on Client Computers Start FME Registration Installing a Permanent Three-Server Redundant Floating License Server Download and Run the Installer Start the License Servers Install FME on Client Computers Borrowing a License Connect to the Floating License Server Specify the Terms of the License Return the License 22 5 Installing FME Desktop on Linux and UNIX Installing FME Desktop on Linux 25 FME Installation and Licensing Manual v

6 6 Installing Single-Fixed Licenses on Linux and UNIX Before You Begin Installing Single-Fixed Licenses on Linux Installing a License File Provided by Safe Software Installing Single-Fixed Licenses on UNIX Updating the FME Version 33 7 Installing Floating Licenses on Linux and UNIX Before You Begin Locating the FLEXlm License Server Files Preparing for a New Floating License Creating a Directory for the FLEXlm License Server Providing the Information to Generate a Floating License Installing a New Floating License Configuring FME Desktop to Use a Floating License Configuring FME Desktop on Linux Configuring FME Desktop on UNIX Installing a Permanent Three-Server Redundant Floating License Server Download and Run the Installer Start the License Servers Run the FME Licensing Assistant and Connect to the First Server Starting FME from the Command Line 44 8 Installing Grid Shift Files Installing Grid Shift Files on Microsoft Windows Installing Grid Shift Files on Linux or UNIX 45 9 Using FME Desktop with Third-Party Applications FME Integration Console Reverting and Extending Applications 48 vi FME Installation and Licensing Manual

7 About_Installing_FME_Server Installing and Licensing FME Server For complete FME Server installation and licensing procedures, see the FME Server Administrator s Guide, located at Epedia.safe.com/articles/How_To/Installing-FME-Server.

8

9 1 Getting Started This manual contains procedures for: FME Desktop installation on Microsoft Windows, UNIX, and Linux FME Desktop and FME Server licensing 1.1 Before You Begin Before installing FME Desktop, Safe Software recommends that you exit all programs, and ensure that the installation directory has access permission for all FME users who may log onto that computer. 1.2 Supported Platforms Windows 32-bit Windows 8 Windows 7 Windows Vista Windows 2008 Server Windows 2003 Server Windows XP SP1 Windows 64-bit Windows 8 Windows 7 Windows Vista Windows 2008 Server (with the win64 platform) FME Installation and Licensing Manual 1

10 1 Getting Started All 64-bit Windows editions listed above also support 32-bit FME. Please see the Guide for Running 64-bit FME for details on differences between 32-bit and 64-bit FME. 1.3 Minimum System Specifications System specifications will vary depending on your FME usage, including the size of your data files. However, at minimum, we recommend: Intel Pentium III or 4 processor 1 GB of RAM 1.5 GB of available hard-disk space To install FME on a server for use with a thin-end client (for example, a Citrix installation), you need to use FME floating licenses To install floating licenses, you must be running a TCP/IP network. 1.4 Linux and UNIX System Requirements Safe Software provides a FME Desktop Light edition. This edition does not include the Workbench component. Supported Platform Linux Intel x64 (64-bit Red Hat Enterprise Linux 5) (linux-x64) For more information on support of this platform, please contact support@safe.com. 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 at the time of your request for evaluation or purchase. 2 FME Installation and Licensing Manual

11 1.6 FME Community Single-Fixed License A single-fixed FME license is designed to enable FME to work on a single specified computer Floating License A floating license enables a number of concurrent users to simultaneously access a single FME deployment. FLEXlm technology provides the floating license capability to FME. You can download the Safe FLEXlm installer from: The FLEXlm software is installed on a computer that acts as a license server by issuing a license to any client computer that requests one. If the number of user requests exceeds the number of floating licenses purchased, a user waits until one of the active FME users closes FME on their computer so that the FME license is returned to the license server FME Community Our online community consists of an enthusiastic group of users and Safe Software staff who participate in various online resources. These technical resources are a forum where FME users ask questions, receive help, and exchange information on FME products. We welcome and encourage questions about FME formats, processing capabilities, future plans, documentation, FME Objects, mapping files, and coordinate conversion issues. FME Installation and Licensing Manual 3

12 1 Getting Started FMEpedia FMEpedia is Safe Software's user collaboration site. Based on Mediawiki, FMEpedia is maintained both by Safe Software staff and members of the FME community. To access these resources, visit FME User Central The FME User Central page is the access point that lets you quickly source various technical resources, and the latest news and technical bulletins. To access these resources, visit FME Training Safe Software provides courses and resources for both FME Desktop and FME Server, offered at a range of skill levels. You can choose how you want to learn: in-person, on-line instructor-led, or with self-paced resources like tutorials and demos. To access these resources, visit 4 FME Installation and Licensing Manual

13 2 Installing FME Desktop on Microsoft Windows 2.1 Installing FME Desktop If you downloaded FME from double-click the downloaded file and click Run when prompted. If you have an FME installation disk, insert it into the DVD drive. If the autorun feature is enabled on your computer, FME starts the installation process. If not, browse to the DVD drive and double-click autorun.exe. On the Welcome to FME Desktop menu, click Install FME Desktop. Follow the instructions in the installation wizard 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 have saved in your FME installation directory. 1. Insert the installation disk into the DVD drive. If the autorun feature is enabled on your computer, FME starts the installation process. If not, browse to the DVD drive and double-click autorun.exe. 2. If the installation wizard finds a previously installed version of FME, it asks if you 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 FME software, use the Add/Remove Programs option on the Control Panel to uninstall any previous versions of FME. You should not have more than one version of FME on your computer. 3. On the Welcome to FME Desktop menu, click Install FME Desktop. 4. Follow the instructions in the installation wizard. FME Installation and Licensing Manual 5

14 6 FME Installation and Licensing Manual

15 3 Installing Single-Fixed Licenses on Microsoft Windows 3.1 Before You Begin Your serial number is printed on your welcome letter and your invoice. If you do not know or cannot find your serial number, please send an to 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 and moved around among many physical machines. Installing FME on a virtual machine requires a floating license. For further details, please refer to Activating a Single-Fixed License If you have a serial number and an Internet connection, follow these steps to activate a fixed license from Safe Software. Note: If you already have a licensed installation, you will be prompted 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 in the corresponding field, and click Activate. FME Installation and Licensing Manual 7

16 3 Installing Single-Fixed Licenses on Microsoft Windows 4. Click Finish. You will see a confirmation message when FME Desktop is successfully licensed. Other Licensing Options Three additional licensing options are available in this dialog. To connect to a floating license server, see 4.1. To activate a trial version of FME, visit: /evaluation/index.php To install a license file provided by Safe Software, see Installing a License File Provided by Safe Software Follow the steps below if you have a problem with the automated license generator. If this happens, you will need to install a license file (*.fmelic) provided by Safe Software. 8 FME Installation and Licensing Manual

17 3.2 Activating a Single-Fixed License If you already have the license file, active a single-fixed license by following these steps: 1. Send an message to codes@safe.com with the following: serial number your 10-digit registration key, which is located at the bottom left corner of the install pane: Note that the number shown here is an example only. You will receive an message from Safe Software with an attached.fmelic license file. Note for Linux users: Once FME Desktop is installed, 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. FME Installation and Licensing Manual 9

18 3 Installing Single-Fixed Licenses on Microsoft Windows 4. Click Finish. FME Desktop is successfully licensed. Note: Licenses are tied to physical properties of systems. If you change your system's hardware configuration, your FME license may not work and you will need to request a new one. 10 FME Installation and Licensing Manual

19 4 Installing Floating Licenses on Microsoft Windows 4.1 Installing a Floating License An FME floating license allows a networked license server computer to provide FME floating licenses to multiple FME users on a network. It is highly recommended that FME is installed locally on each computer; however, it is possible to install FME on a single network application server rather than on each desktop. You can use the floating license capability for all FME editions, and each license server can serve different FME licenses. For example, if a site requires floating licenses for both FME Base Edition and FME Smallworld Edition, you can choose both licenses from one floating license server. Note: The preceding paragraph does not apply to floating licenses with different expiry dates. If you need to transfer an existing floating license to a new license server, you have to perform a new installation since you still need to request a new license file to Safe Software Before You Begin Ensure that the following requirements are met before beginning the installation: You must be running a TCP/IP network. You must designate one computer on the network as the license server. The license server can be any computer on the network that is visible to all computers that are dependent on it for their licenses. Select a computer that is always running and always connected to the network, because the client computers must be able to communicate with the license server to use FME. The processing load on the licensing server is negligible. You must have administrator privileges to install the FME floating license server. FME Installation and Licensing Manual 11

20 4 Installing Floating Licenses on Microsoft Windows If the computer you want to use as your floating license server has a firewall, you must open a range of ports through which the FlexServer can communicate. If FLEXlm is already installed on your license server, you still need to perform a new installation. FME 2011 requires the version of FLEXlm that is included in the installer. In addition, if your organization is configuring license borrowing (see 4.3), you will require LMTOOLS version 11.8 or newer. Note: The FME license server cannot be installed on a virtual machine that is built and moved around among many physical machines. It must be locked to a single fixed MAC address Download and Run the Installer The FME installation disk contains the utility program required to get the license 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 the license server: 1. Run (double-click) the installer to create a FlexServer directory. The following table lists the shortcuts that are created in the Safe Software program group. Shortcut Generate hostid.txt Launch LMTOOLS License Administration Guide Description Creates text file to send to codes@safe.com. Launches LMTOOLS. Used for debugging or changing configuration. Opens Flexera Software s License Administration Guide. 12 FME Installation and Licensing Manual

21 4.1 Installing a Floating License Shortcut Start - Restart FME License Server View FME License Server Log View hostid.txt View Readme Description Starts the license manager process. Opens the license manager log file. Used for debugging. Reopens text file to send to codes@safe.com. Opens the installation and configuration instructions. Note: You should use the current versions of lmgrd license manager and lmutil end user utilities, available from the Downloads area of The other files are required for new FME installations only Request and Install the License Perform the following steps on the computer that acts as the license server: 1. Click Start > Programs > Safe Software > View hostid.txt to open the hostid.txt file. Note: If you re installing FLEXlm on Windows Vista, you need to right-click Start-Restart FME License Server and run this function using administrator privileges. 2. Copy and paste the contents of hostid.txt file to an . Include your FME serial number and name, and send it to codes@safe.com. The serial number is printed on your welcome letter and on your invoice. Safe Software will send you the license file. 3. When you receive the safe.lic file, copy it into the FlexServer directory; for example, c:\program files\flexserver\. FME Installation and Licensing Manual 13

22 4 Installing Floating Licenses on Microsoft Windows 4. Go to Start > Programs > Safe Software, and choose Start - Restart FME License Server Install FME on Client Computers After the license server is running, install FME on the client computers or on the Network Server (if you have a fast and non-congested network). Note: If this is a license upgrade from fixed license to floating license (and not a new FME installation), then ensure that there are no existing fme_license.dat files in the licenses directory; for example, check C:\Program Files\FME\licenses. Also ensure there are no FME tasks running before starting the registration process Start FME Registration Perform this step for each computer that has FME installed. 1. To open the FME Licensing Assistant, click Start > Programs > FME Desktop > Utilities > FME Licensing Assistant. 14 FME Installation and Licensing Manual

23 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 computer 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, select the license that you want to use. 5. Click Finish to complete the connection. 4.2 Installing a Permanent Three-Server Redundant Floating License Server FLEXlm allows for redundancy by using a set of three license servers. With three-server redundancy, the floating license server stays functional, handing out its total complement of licenses when any two of the three license servers are up and running. A master server that performs all licensing operations is elected when the redundant servers are started. The other two servers are there to provide a secure licensing mechanism in the event of hardware failure or if the master node needs to be rebooted. FME Installation and Licensing Manual 15

24 4 Installing Floating Licenses on Microsoft Windows It is not a requirement for each of the server nodes to have the same architecture or operating system, although they should have reliable network communications with each other and should be on the same subnet. Often, this means that the three servers are located physically close to each other. If you have any questions about this topic, send an message with your questions to codes@safe.com Download and Run the Installer The FME installation disk contains the utility program that is needed to get 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 settings may prevent access to the installer. You can 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. The table that follows lists the shortcuts that are created in the Safe Software program group: Shortcut Generate hostid.txt Launch LMTOOLS License Administration Guide Description Creates text file to send to codes@safe.com. Launches LMTOOLS. Used for debugging or changing configuration. Opens Flexera Software s License 16 FME Installation and Licensing Manual

25 4.2 Installing a Permanent Three-Server Redundant Floating License Server Shortcut Start - Restart FME License Server View FME License Server Log View hostid.txt View Readme Description Administration Guide. Starts the license manager process. Opens the license manager log file. Used for debugging. Reopens text file to send to codes@safe.com. Opens the installation and configuration instructions. Install the floating license server on three different computers using the instructions in the previous sections. Send an to codes@safe.com and include the FLEXlm Host ID, the hostname assigned to each of the computers. (The serial number is printed on your welcome letter and on your invoice.) We will you a file called safe.lic that contains the key code file for the license code servers. Copy the safe.lic file into each of the Flex- Server directories on your license server nodes 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 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 host SERVER host SERVER host FME Installation and Licensing Manual 17

26 4 Installing Floating Licenses on Microsoft Windows VENDOR safe FEATURE 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 You can modify the port numbers to any unused port number in the range 1024 to You can change the order of the SERVER lines to suggest which node is the master node, however we recommend you keep the order shown in the preceding example Install FME on Client Computers When the server license files are running, install FME on the client computers or on the Network Server (if you have a fast and uncongested network). If this is not a new install (but rather a license upgrade from fixed license to floating), ensure that there are no existing fme_ license.dat or fme_license.fmelic files in the C:\Program Files\FME\licenses directory. Using a text editor, create a file called fme_license.dat that contains the same three SERVER lines from the safe.lic files that were used to start the redundant server nodes. Add a USE_SERVER line after the SERVER lines, as shown in the following example: SERVER host SERVER host SERVER host USE_SERVER Place this fme_license.dat file in the FME client installation directory; that is, in the C:\Program Files\FME\licenses directory. 18 FME Installation and Licensing Manual

27 4.3 Borrowing a License 4.3 Borrowing a License If your FME Desktop product uses a floating license, and your organization supports this option, you can borrow a license for offline use. A fixed license configuration does not allow you to borrow a license. In addition to a floating license, you need a floating license server with the license borrowing capabilities enabled. Note: Note that license borrowing requires LMTOOLS version 11.8 or newer. If a license is available, you can borrow it and run FME for a maximum of 7 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 the expiry date, the license automatically becomes available for other users to borrow. You do not have to return the license after an expiry date; however, you can choose to return a license early. See 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 server name.) 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, enter the name of the floating license server. 3. Click Next. FME Installation and Licensing Manual 19

28 4 Installing Floating Licenses on Microsoft Windows 4. Select the license type from the list, and click Activate. 20 FME Installation and Licensing Manual

29 4.3 Borrowing a License 5. Click Finish. You will see a message when you are successfully connected to the floating license server. To borrow the license for offline use, you will have to start FME Workbench and specify the terms of the license. See 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. FME Installation and Licensing Manual 21

30 4 Installing Floating Licenses on Microsoft Windows You have successfully borrowed the floating license for the specified number of days. To run FME Desktop during this time frame, you do not need to be connected to the license server 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 license early. Click OK. 4. Click OK. 22 FME Installation and Licensing Manual

31 4.3 Borrowing a License The license is now available for other FME Desktop users to borrow. Note: You cannot change or update licenses when you have borrowed a floating license. You need to return a borrowed license first. FME Installation and Licensing Manual 23

32 24 FME Installation and Licensing Manual

33 5 Installing FME Desktop on Linux and UNIX All installation steps must be performed under the same user account. Please read this section carefully in order to determine under which user account to install FME Desktop on your system. The following installers are available for various UNIX systems: Platform Solaris Linux Linux Installer Name fme-engine-2012-solaris-sparc64.run (no GUI) fme-engine-linux-2012-x64.run (no GUI) fme-desktop-linux-2012-x64.run (no FME Workbench) Note: Ensure that your system meets all the requirements. See Installing FME Desktop on Linux 1. Download FME Desktop Installer to your local machine. Note: You can download the installer for FME Desktop Linux x64 Edition from: For other FME Desktop UNIX editions, please contact 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 sudo command on some distributions). If you run the installer as a regular (non-root) user: FME Desktop is installed for the current user ONLY. The default install location is $HOME/fme. FME Installation and Licensing Manual 25

34 5 Installing FME Desktop on Linux and UNIX If you run the installer as root (or via sudo): FME Desktop is installed for ALL users 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 the installer. Note: Before running the installer, please ensure that the installer has execute permission. Use one of following methods: Right-click on the executable and select Properties > Permission > Check, or 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 or change some defaults: Do you wish to associate format file types with FME? [No] : Yes Will you be performing Nad83/Nad27 Datum shifts in Canada? [No] : Yes Would you like to install the FME Software Development Kit? [No] : Yes Note: The default selection is shown in brackets. Once the installation is complete, the installer will generate a configuration file: opt/fme/install.cfg 26 FME Installation and Licensing Manual

35 5.1 Installing FME Desktop on Linux To perform this installation automatically, run the installer from the command line. FME Installation and Licensing Manual 27

36 28 FME Installation and Licensing Manual

37 6 Installing Single-Fixed Licenses on Linux and UNIX 6.1 Before You Begin Your serial number is printed on your welcome letter and your invoice. If you do not know or cannot find your serial number, please send an to 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 and moved around among many physical machines. Installing FME on a virtual machine requires a floating license. For further details, please refer to Installing Single-Fixed Licenses on Linux A single-fixed FME license enables FME to work on a single specified computer. If more than one user installs FME, each user has to install a fixed license on their computer. Note: If you change your system's hardware configuration after installation, your FME license may not work and you will need to request a new one. 1. Once FME Desktop is installed on Linux, log in as the same user who installed FME 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 corresponding field and click Activate. FME Installation and Licensing Manual 29

38 6 Installing Single-Fixed Licenses on Linux and UNIX 5. Click Finish. You will see a confirmation message when FME Desktop is successfully licensed Installing a License File Provided by Safe Software Follow the steps below if you have a problem with the automated license generator. 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 following these steps: 1. Send an message to codes@safe.com with the following: serial number your 10-digit registration key, which is located at the bottom left corner of the install pane: 30 FME Installation and Licensing Manual

39 6.2 Installing Single-Fixed Licenses on Linux Note that the number shown here is an example only. You will receive an message from Safe Software with an attached.fmelic license file. Note for Linux users: Once FME Desktop is installed, 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. FME Installation and Licensing Manual 31

40 6 Installing Single-Fixed Licenses on Linux and UNIX Note: Licenses are tied to physical properties of systems. If you change your system's hardware configuration, your FME license may not work 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 run the runfme program (with no arguments) to obtain the registration number:./runfme Unless there is licensing information already present in this location, you receive an error message that includes the computer registration number: FME license system failure. Contact your Distributor. Your machine key is Write down the 10-digit number and send an message to codes@safe.com. Include your operating system type and version number; for example, Linux Intel x64. We will send you an.fmelic license file. To register this license from the install directory, run this command: runfme <licensefilebasename.fmelic> Note: Remember that you must register FME as the same user who untarred the installation file. 2. The easiest way to run FME is to use the runfme script. This script sets the FME_HOME and LD_LIBRARY_PATH (or LIBPATH or SHLIB_PATH, depending on the platform) environment variables, and then runs FME. For best results, store the runfme script in the same directory as the FME and its other support files. If the FME installation directory is in the user's path, you can run the runfme script as follows: runfme <normal FME arguments> 32 FME Installation and Licensing Manual

41 6.3 Installing Single-Fixed Licenses on UNIX If the script is moved out of the FME installation directory, it must be updated so that the default value of FME_HOME points to the installation directory. 3. All users who want to access FME without using the runfme script must have their environments set up correctly. This is normally done by adjusting each user s login script to set the FME_HOME environment variable, and adding FME_HOME/fme core into thepath and LD_LIBRARY_PATH environment variables. The way to make this change depends on your configuration and which UNIX shell you use; however, if you use the C-Shell, you can set up your own environment by adding these lines to your.cshrc: setenv FME_HOME /opt/fme set path = ($path $FME_HOME) setenv LD_LIBRARY_PATH $FME_HOME/fmecore:$LD_LIBRARY_ PATH Your System Administrator may be able to make changes in one place so they can be accessed by all users. Alternatively, you can edit the runfme script in the FME installation directory. The script s header comments outline the required modifications 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 to a safe place. 2. After you have installed the new FME version, copy the.fmelic license 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. FME Installation and Licensing Manual 33

42 6 Installing Single-Fixed Licenses on Linux and UNIX Note: You can store multiple versions of FME for UNIX; however, Safe Software recommends that you keep only one version active. 34 FME Installation and Licensing Manual

43 7 Installing Floating Licenses on Linux and UNIX A floating license enables a number of concurrent users to simultaneously access a single FME deployment. FLEXlm technology provides the floating license capability to FME. For a full description, visit Flexera Software s website: The FLEXlm software is installed on a computer that acts as a license server by issuing a license to any client computer that requests one. If the number of user requests exceeds the number of floating licenses purchased, a user will need to wait until one of the active FME users closes FME on their computer so that the FME license is returned to the license server. This chapter covers among other topics: Before You Begin You must be running a TCP/IP network. One computer on the network is designated as the license server. The license server may be any computer on the network that is visible to all computers that are dependent on it for their licenses. You should choose a computer that is always running and always connected to the network because the client computers must be able to communicate with the license server to use the FME. The processing burden on the licensing server is negligible. You must have Administrator privileges to install the FME Floating License server. If the computer you want to use as your floating license server has a firewall, you must open a port through which the FlexServer can communicate. By FME Installation and Licensing Manual 35

44 7 Installing Floating Licenses on Linux and UNIX default, the range of ports used is , although you can also configure other ports. 7.2 Locating the FLEXlm License Server Files Please read and understand the following steps before attempting to use FLEXlm 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 from the FME installation disk, or go to Safe Software s FTP site and save one of the following files: ftp://ftp.safe.com/fme/floatinglicense/flexserver11_8- linux-x64.tar.gz 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 set up a FLEXlm server on UNIX, and it contains the FLEXlm license server software. You should install this software on your license server computer, which is the computer that will manage the licenses. Note: Current versions of lmgrd license manager and lmutil end user utilities are also available from the Downloads area of Preparing for a New Floating License There are several things you must do to prepare to install a new floating license, each of which is described here Creating a Directory for the FLEXlm License Server You need to create a directory for the FLEXlm license server and extract the 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 36 FME Installation and Licensing Manual

45 7.3 Preparing for a New Floating License % gunzip < ~/flexserver11_8-solaris-sparc64.tar.gz tar xf - This directory is referred to as the FlexServer directory for the remainder of these instructions Providing the Information to Generate a Floating License Safe Software requires three pieces of information to generate a floating or node-locked license: hostname host ID FME serial number Obtaining the Hostname To obtain the hostname, type the hostname command. For example: % hostname worf In this example, the host name is worf Determining the Host ID To determine the host ID, use the lmutil lmhostid command within the FlexServer directory. The output should be an eight-character alphanumeric string (or a 12-character alphanumeric string on Linux). For example: %./lmutil lmhostid lmutil - Copyright (c) The 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 following error message: >-bash:./lmutil: No such file or directory This error appears when FLEXlm is missing necessary libraries to run on Linux. To clear the error, install lsb-core by typing the command: FME Installation and Licensing Manual 37

46 7 Installing Floating Licenses on Linux and UNIX sudo apt-get install lsb-core Determining the FME Serial Number To determine the serial number, look at your welcome letter or your invoice. Send an message to and include the host ID, the host name, and the FME serial number. Safe Software will e- mail you a file called safe.lic that contains the key code file for the license code server. Copy the safe.lic file into the FlexServer directory on your license server computer. Note: The filename must remain in lowercase text. Safe Software recommends that you do not change the filename. If you want to change the file contents (for example, change a port number), please refer to the FLEXlm User s Guide, available on your FME installation disk. 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 terminal. To store the log to a file instead, use the -l option: %./lmgrd -c./safe.lic -l safe.log When a log file is used, lmgrd detaches as a background process, so there is no need to explicitly background the application. However, you ll have to start the server each time the license server host is 38 FME Installation and Licensing Manual

47 7.5 Configuring FME Desktop to Use a Floating License rebooted. The system administrator can make sure the preceding command is run at system start-up time. 7.5 Configuring FME Desktop to Use a Floating License To configure an installation of FME to use a particular license server, follow these steps Configuring FME Desktop on Linux 1. Once FME Desktop is installed on Linux, log in as the same user who installed FME Desktop. 2. Navigate to Applications > FME Desktop > Utilities > FME Licensing Assistant. The FME Licensing Assistant opens. 3. On the FME Licensing Assistant, select Connect to a floating license server 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. FME Installation and Licensing Manual 39

48 7 Installing Floating Licenses on Linux and UNIX 6. Click Finish. A floating license is installed to borrow a license. 40 FME Installation and Licensing Manual

49 7.5 Configuring FME Desktop to Use a Floating License Configuring FME Desktop on UNIX To configure an installation of FME Desktop on UNIX to use, create a text file called fme_license.dat in the FME license directory. The license server may or may not be the host where FME Desktop is installed, and could even be a Windows host that is already running floating licenses. Note: Any examples shown here are simple configurations based on default port numbers. However, FLEXlm lets you set up other configurations, as well as specify locations for the license server through environment variables. If you want to do this, please skip the steps that follow and refer to detailed instructions in the FLEXlm User s Guide. The safe.lic file we provide when you re preparing to install a floating license is used to configure the floating license server. It is necessary for each FME installation to have a separate fme_license.dat file that tells FME which computer to connect with when looking for license information. 1. Remove existing license files. 2. Make sure that the FME installation directory is cleared of any files named fme_license.dat and fme_license.fmelic. 3. Create a file that contains the following information: SERVER <ServerHostName> Any USE_SERVER In a few of the previous examples, the server was installed onto a host named worf on a local network, using the default port number. The following command uses this example to create the needed license file. % cd /opt/fme % cat > fme_license.dat SERVER worf Any USE_SERVER <Ctrl+d> (Typing Ctrl+d ends the input to fme_license.dat.) FME Installation and Licensing Manual 41

50 7 Installing Floating Licenses on Linux and UNIX 7.6 Installing a Permanent Three-Server Redundant Floating License Server FLEXlm allows for redundancy by using a set of three license servers. With three-server redundancy, the floating license server stays functional, handing out its total complement of licenses when any two of the three license servers are up and running. A master server that performs all licensing operations is elected when the redundant servers are started. The other two servers are there to provide a secure licensing mechanism in the event of hardware failure or if the master node needs to be rebooted. It is not a requirement for each of the server nodes to have the same architecture or operating system, although they should have reliable network communications with each other and should be on the same subnet. Often, this means that the three servers are located physically close to each other. If you have any questions about this topic, send an message with your questions to codes@safe.com Download and Run the Installer Install the floating license server on three different computers using the instructions in sections 7.1 through 7.4. Send an to codes@safe.com and include the FLEXlm Host ID, the hostname assigned to each of the computers. (The serial number is printed on your welcome letter and on your invoice.) We will you a file called safe.lic that contains the key code file for the license code servers. Copy the safe.lic file into each of the FlexServer directories on your license server nodes Start the License Servers Start the license manager on all three servers, in order based on the following: 42 FME Installation and Licensing Manual

51 7.6 Installing a Permanent Three-Server Redundant Floating License Server 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 host SERVER host SERVER host VENDOR safe FEATURE 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 You can modify the port numbers to any unused port number in the range 1024 to You can change the order of the SERVER lines to suggest which node is the master node, however we recommend you keep the order shown in the preceding example. To start the license server: % <FlexServerDir>/lmgrd -c <FLEXServerDir>/safe.lic This action runs the server in the foreground, logging activity to the terminal. To store the log to a file instead, use the -l option: %./lmgrd -c./safe.lic -l safe.log When a log file is used, lmgrd detaches as a background process, so there is no need to explicitly background the application. However, you ll have to start the server each time the license server host is rebooted. The system administrator can make sure the preceding command is run at system start-up time Run the FME Licensing Assistant and Connect to the First Server For instructions, see 7.5. FME Installation and Licensing Manual 43

52 7 Installing Floating Licenses on Linux and UNIX 7.7 Starting FME from the Command Line For information on using FME from the command line, please see the FME Fundamentals manual, available at: 44 FME Installation and Licensing Manual

53 8 Installing Grid Shift Files 8.1 Installing Grid Shift Files on Microsoft Windows FME supports conversions between coordinate systems using different datums. Many datum transformations are not mathematically definable and require the use of grid of shifts. If you attempt to perform a datum transformation of this kind without the appropriate grid shift file in place, FME stops the translation. When you install FME for Windows, the grid shift files provided by Safe Software are automatically installed in the correct location. If you have already installed FME, you can find more information on which files are included by opening Workbench help and clicking on the Coordinate Systems topic, or by choosing Tools > Browse Coordinate Systems and pressing the F1 key. You can manage grid shift files by choosing Tools > FME Options > Coordinate Systems. Click the Help button for more information on how you can maintain grid shift files. 8.2 Installing Grid Shift Files on Linux or UNIX When you install FME for Linux/UNIX, the grid shift files provided by Safe Software are automatically installed in the correct locations. You can find more information on which files are included in Linux and UNIX installations by viewing our FMEpedia site: FMEpedia.com/index.php/Datum_Transformations_and_Grid_ Shift_Files The files in the Reproject subdirectory of your FME installation folder include a path to the location of your grid file. The order in which the grids are listed is the order in which FME uses them. FME Installation and Licensing Manual 45

54 8 Installing Grid Shift Files To register a file, add the full pathname of the file to the beginning of the appropriate.gdc file. For example, in Nad27ToNad83.gdc, add: fmehome\reproject\griddata\canada\ntv2_0.gsb To make sure the files were registered correctly, check the log file when you run a translation. Note: If you have access to the FME Workbench user interface, you can manage grid shift files through the Workbench > Tools > FME Options menu. Click the Coordinate Systems icon. 46 FME Installation and Licensing Manual