When you install (or upgrade) PingFederate using its platform-specific installer, PingFederate is configured to run as a service. You can optionally stop (and disable) the service and run PingFederate as a console application.

If you install (or upgrade) PingFederate manually by using the PingFederate product distribution file (or the Upgrade Utility in command line), you can run PingFederate as a console application or install the PingFederate service manually and run it as a service.

Depending on the application mode and the operating system, the steps to start, stop, or restart PingFederate vary.

  • Follow the relevant steps to start PingFederate:
    Operating system Application mode Steps
    Windows Console application
    1. Open a command prompt.
    2. Go to the <pf_install>/pingfederate/bin directory.
    3. Run run.bat.
    4. Keep the command prompt open.
    Windows service
    1. Open the Control Panel > Administrative Tools > Services management console.
    2. Right-click on the PingFederate service and select Start.
    3. Close the Services management console when the PingFederate Windows service is started.
    Linux Console application
    1. Open a terminal window.
    2. Go to the <pf_install>/pingfederate/bin directory.
    3. Run run.sh.
    4. Keep the terminal window open.
    Service
    1. Open a terminal window.
    2. Enter the system-dependent service command to start the Pingfederate service.
    3. Close the terminal window when the PingFederate service is started.
  • Follow the relevant steps to stop PingFederate:
    Operating system Application mode Steps
    Windows Console application
    1. Locate the command prompt that is running the PingFederate program.
    2. Use the CTRL+C key combination to terminate the PingFederate program.
    3. Close the command prompt when the PingFederate program is stopped.
    Windows service
    1. Open the Control Panel > Administrative Tools > Services management console.
    2. Right-click on the PingFederate service and select Stop.
    3. Close the Services management console when the PingFederate Windows service is stopped.
    Linux Console application
    1. Locate the terminal window that is running the PingFederate program.
    2. Use the CTRL+C key combination to terminate the PingFederate program.
    3. Close the terminal window when the PingFederate program is stopped.
    Service
    1. Open a terminal window.
    2. Enter the system-dependent service command to stop the Pingfederate service.
    3. Close the terminal window when the PingFederate service is stopped.
  • Follow the relevant steps to restart PingFederate:
    Operating system Application mode Steps
    Windows Console application
    1. Locate the command prompt that is running the PingFederate program.
    2. Use the CTRL+C key combination to terminate the PingFederate program.
    3. Run run.bat again when the PingFederate program is stopped.
    4. Keep the command prompt open.
    Windows service
    1. Open the Control Panel > Administrative Tools > Services management console.
    2. Right-click on the PingFederate service and select Restart.
    3. Close the Services management console when the PingFederate Windows is started.
    Linux Console application
    1. Locate the terminal window that is running the PingFederate program.
    2. Use the CTRL+C key combination to terminate the PingFederate program.
    3. Run run.sh again when the PingFederate program is stopped.
    4. Keep the terminal window open.
    Service
    1. Open a terminal window.
    2. Enter the system-dependent service command to restart the Pingfederate service.
    3. Close the terminal window when the PingFederate service is restarted.