You are here: Administrator's Guide > Installation Options > Distributed Installation > Installing for Active-Passive Failover > Install the FME Server Web Services and Configure for Failover

Install the FME Server Services and Configure for Failover

Perform the following tasks:

  1. Install the FME Server Services
  2. Configure the FME Server Services for Failover
  3. Configure Firewall Settings
  4. (Oracle WebLogic only) Disable WebLogic Authentication

Install the FME Server Services

ClosedWindows
  1. Start the FME Server Installer on the <webHost>.
  2. Select the Distributed Install.
  3. On the Custom Setup dialog, select only the Web Services component for installation.
  4. The installer prompts you for the UNC path to the remote file system.
  5. The installer prompts you for the name of the FME Server Host. Enter the host name of the computer you want to serve as the primary FME Server Core host (<coreHost>). Do not specify the failover core host machine.
  6. The installer prompts you to install a web application server. If already provided, it is recommended that you shut down the service during installation.
ClosedLinux

  1. On the <webHost>, mount the FME Server installation directory shared on the <coreHost>:

    mount <coreHost>:<FMEServerDir>/home/FMEServer

  2. Start the FME Server Installer.
  3. Select the Distributed (Custom) install option.

  4. At the feature selection dialog, select only the Web Services component.

    The installer prompts you for the name of the FME Server Host.

  5. Enter the host name of the computer you want to serve as the primary FME Server Core host (<coreHost>). Do not specify the failover core host machine.

    The installer prompts you for the path to the remote file system.

  6. Enter the path to the mounted directory.

    The installer prompts you to install a web application server. If already provided, it is recommended that you shut down the service during installation.

  7. Manually start FME Server and configure it to start automatically.

    See Working with the System Services.

  8. In order for the Data Download and Data Streaming web services to reference the correct web host location when outputting results that are returned from an FME Engine, you must manually change this location in your FME Engine configuration files:
    1. Locate your FME Engine configuration files, under <FMEServerDir>\Server\fmeEngineConfig*.txt
    2. For each file, under the SUB_SECTION for FILE_DOWNLOAD_SERVICE and STREAM_DOWNLOAD_SERVICE, modify the SUCCESS_RESPONSE directive as follows:

    From:

    SUCCESS_RESPONSE 0:Translation Successful|OutputLocation=!FME_AUTO_DIR_NAME!

    To:

    SUCCESS_RESPONSE 0:Translation Successful|OutputLocation=<webHost>/DefaultResults/!FME_AUTO_DIR_NAME_SIMPLE!

Following the installation on <webHost>, the FME Server Web Application Server automatically starts.  If you used your own web application server, you can restart that service.

To verify the installation, see Verify the Installation (Windows) or Verify the Installation (Linux).

Configure the FME Server Services for Failover

  1. Open each web application properties file located at:

    <WebAppDir>\<fmeServiceName>\WEB-INF\conf\propertiesFile.properties

  2. Find the following line in this file:

    #FAILOVER_SERVER_NAME=<failoverServerName>

  3. Uncomment this line and replace <failoverServerName> with the name of your FME Server failover Core host. Do not specify the primary Core host. For example:

    FAILOVER_SERVER_NAME=fmecore2

  4. Restart the web application server.

Configure Firewall Settings

The FME Server Services and other clients communicate with the FME Server Core over TCP/IP. Requests are sent to the FME Server Core over port 7071. Result messages are returned to clients over a randomly assigned port created by the FME Server Core. Therefore, be sure to configure any firewall settings on the <webHost> with a rule to allow for full communication with the <coreHost> machines.

(Oracle WebLogic only) Disable WebLogic Authentication

If you are using an Oracle WebLogic server, you must disable WebLogic authentication. This step is necessary to prevent WebLogic from intercepting login requests, which interferes with FME Server authentication.

  1. Locate and open the following configuration file in your WebLogic installation:

    2. <WebLogic_install_dir>/user_projects/domains/<your_domain>/config/config.xml

  2. Add (or change) the following lines before the security configuration closing tag </security-configuration>:

    3. <enforce-valid-basic-auth-credentials>

    false

    </enforce-valid-basic-auth-credentials>

  3. Save and close the file.