Troubleshooting Application Launch Issues at System start

Overview

This article explains how to troubleshoot issues where the application fails to start during the System Startup phase.

Prerequisites

Application Icon, with the `--system-startup` flag in the Start-Up folder (Windows)

OpenFin applications are launched at system startup by creating a copy of the application icon in the system startup folder.  Depending on the startup sequence implemented by the O/S, the network card may not have been initialized when the OpenFin Runtime Version Manager is launched.  OpenFin solves this by waiting for the network to be ready before attempting to access the application manifest.    This mechanism is activated by adding `--system-startup` to the RVM parameters.  Shortcuts in the system-startup folder created by the RVM will already have the `--system-startup` flag added.

Troubleshooting Steps

1. Verify the application can be launched after the O/S had loaded
2. Validate a copy of the Application Icon is available in the Startup folder, normally %appdata%\roaming\microsoft\windows\Start Menu\programs\startup
3. Validate the Application Icon located in the startup folder has the `--system-startup` argument configured
   1. Right Click on the icon
   2. Click Properties
   3. Check the Target includes `--system-startup`