You are here: Administrator's Guide > Other Common Tasks > Licensing and Administration > Working with the FME Server System Services > Configuring FME Server as a System Service (Linux)

Configuring FME Server as a System Service (Linux)

You can configure FME Server as a system service that starts when you start your system. You should do this only if you have set up system services before and understand the different run levels on your system.

WARNING: Configuring scripts to run at start-up on Linux is an advanced task. The steps for doing so vary, depending on your configuration. Use the steps listed in this section as a guide only.

FME Server is composed of a series of components, and each component has its own scripts. Both systemd and SysV scripts are provided.

ClosedConfiguring with systemd Scripts

The following FME Server systemd startup scripts are provided upon installation:

  • <FMEServerDir>/Server/startup/systemd/fmeserver-appserver.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-cleanup.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-core.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-database.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-engines.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-websocket.service
  • <FMEServerDir>/Server/startup/systemd/fmeserver-queue.service

Copy these scripts and place them in the following directory, depending on your privilege level:

  • root privilege: /etc/systemd/system/
  • user-level privilege (no system administration rights): /usr/lib/systemd/system/

To enable startup scripts to run at system boot time

Run the following command for each script:

systemctl enable *.service

For example:

systemctl enable fmeserver-core.service

To disable startup scripts from running at system boot time

Run the following command for each script:

systemctl disable *.service

For example:

systemctl disable fmeserver-core.service

To start services manually

Run the following command for each script:

systemctl start *.service

For example:

systemctl start fmeserver-core.service

To stop services manually

Run the following command for each script:

systemctl stop *.service

For example:

systemctl stop fmeserver-core.service

ClosedConfiguring with SysV Scripts

Make a copy of the FME Server startup scripts:

  • <FMEServerDir>/Server/startup/SysV/FMEServerAppServer
  • <FMEServerDir>/Server/startup/SysV/FMEServerCleanup
  • <FMEServerDir>/Server/startup/SysV/FMEServerCore
  • <FMEServerDir>/Server/startup/SysV/FMEServerDatabase
  • <FMEServerDir>/Server/startup/SysV/FMEServerEngines
  • <FMEServerDir>/Server/startup/SysV/FMEServerWebSocket
  • <FMEServerDir>/Server/startup/SysV/FMEServerQueue

Place the scripts here:

  • /etc/init.d/FMEServerAppServer
  • /etc/init.d/FMEServerCleanup
  • /etc/init.d/FMEServerCore
  • /etc/init.d/FMEServerDatabase
  • /etc/init.d/FMEServerEngines
  • /etc/init.d/FMEServerWebSocket
  • /etc/init.d/FMEServerQueue

From the /etc/init.d/ directory, update permissions on these files with the following chmod command:

sudo chmod +x FME*

Create links from the scripts you just copied to a script in the correct run level, depending on your distribution and configuration.

For Debian, this is typically 2 (rc2.d), and for Red Hat and Fedora, this is typically 5 (rc5.d). If you are unsure what run level to use, contact your system administrator before proceeding.

If you are on a Debian based distribution such as Ubuntu, run the following commands:

update-rc.d FMEServerAppServer start 99 2 . stop 99 6 .

update-rc.d FMEServerCleanup start 99 2 . stop 99 6 .

update-rc.d FMEServerCore start 99 2 . stop 98 6 .

update-rc.d FMEServerDatabase start 98 2 . stop 99 6 .

update-rc.d FMEServerEngines start 99 2 . stop 98 6 .

update-rc.d FMEServerWebSocket start 99 2 . stop 99 6 .

update-rc.d FMEServerQueue start 97 2 . stop 99 6 .

On Red Hat, use the chkconfig command. This automatically adds them to runlevel 3. If you need to use a different run level, modify the chkconfig header of these scripts, or manually:

chkconfig --add FMEServerAppServer

chkconfig --add FMEServerCleanup

chkconfig --add FMEServerCore

chkconfig --add FMEServerDatabase

chkconfig --add FMEServerEngines

chkconfig --add FMEServerWebSocket

chkconfig --add FMEServerQueue

On other distributions, or to manually set up the startup scripts, create the proper links in the appropriate run level directory.

The following steps use a run level of 2.

  • Create the Web Application Server startup link:

    • sudo ln -s /etc/init.d/FMEServerAppServer /etc/rc2.d/S99fmeserverappserver

  • Create the FME Server Core startup link:

    • sudo ln -s /etc/init.d/FMEServerCore /etc/rc2.d/S99fmeservercore

  • Create the Database Server startup link:

    • sudo ln -s /etc/init.d/FMEServerDatabase /etc/rc2.d/S98fmeserverdatabase

    Note: It is important that this is S98, not S99.

  • Create the FME Server Engines startup link:

    • sudo ln -s /etc/init.d/FMEServerEngines /etc/rc2.d/S99fmeserverengines

  • Create the FME Server Cleanup service link:

    • sudo ln -s /etc/init.d/FMEServerCleanup /etc/rc2.d/S99fmeservercleanup

  • Create the FME Server Queue startup link:

    • sudo ln -s /etc/init.d/FMEServerQueue /etc/rc2.d/S97fmeserverqueue

  • Create the FME Server WebSocket service link:

    • sudo ln -s /etc/init.d/FMEServerWebSocket /etc/rc2.d/S99fmeserverwebsocket

  • Create the Web Application Server shutdown link:

    • sudo ln -s /etc/init.d/FMEServerAppServer /etc/rc6.d/K99fmeserverappserver

  • Create the FME Server Cleanup service shutdown link:

    • sudo ln -s /etc/init.d/FMEServerCleanup /etc/rc6.d/K98fmeservercleanup

    Note: It is important to specify K98, not K99.

  • Create the FME Server Core shutdown link:

    • sudo ln -s /etc/init.d/FMEServerCore /etc/rc6.d/K98fmeservercore

    Note: It is important to specify K98, not K99.

  • Create the Database Server shutdown link:

    • sudo ln -s /etc/init.d/FMEServerDatabase /etc/rc6.d/K99fmeserverdatabase

  • Create the FME Server Engines shutdown link:

    • sudo ln -s /etc/init.d/FMEServerEngines /etc/rc6.d/K98fmeserverengines

    Note: It is important to specify K98, not K99.

  • Create the FME Server Queue shutdown link:

    • sudo ln -s /etc/init.d/FMEServerQueue /etc/rc6.d/K99fmeserverqueue

  • Create the FME Server WebSocket service shutdown link:

    • sudo ln -s /etc/init.d/FMEServerWebSocket /etc/rc6.d/K98fmeserverwebsocket

    Note: It is important to specify K98, not K99.