Starting Applications Manager by using the Java Web Start launcher

This topic describes how to start the Applications Manager from Business Center by using the Java™ Web Start launcher.

1. Set the yfs.yfs.configurator.usewebstart property to true in the customer_overrides.properties file.
2. Log on to Business Center as an Administrator.
3. Click System Setup. The System Setup home page opens.
4. Expand System Applications and then click Applications Manager.
   The browser prompts you to take an action on the launchsbcapplicationmanager.jnlp file. You can perform one of the following actions based on the browser you are using:

   • Internet Explorer:
     • Open: Opens the file with the associated application. If there exists a mapping between the file extension ‘.jnlp’ and the Java Web Start Launcher, you can open it directly. Otherwise, you can save the file and open it.
     • Save: Save the file to the local system and open it with Java Web Start Launcher.
     • Save As: Save the file with a different name to the local system and open it with Java Web Start Launcher.
   • Firefox:
     • Open With: Opens the file with the associated application. If there exists a mapping between the file extension ‘.jnlp’ and the Java Web Start Launcher, you can open it directly. Otherwise, you must manually select the Java Web Start Launcher from the list of programs and open it.
     • Save File: Save the file to the local system and open it with Java Web Start Launcher.
     You can find the Java Web Start Launcher program at <JRE_HOME>\bin\javaws on the local system.

   Once the .jnlp file is run, the Java Web Start downloads the necessary resources such as the JAR files listed in the .jnlp file to start the application. Alternatively, you can also open the file from the command line by running the following command:

   <JRE_HOME>/bin/javaws <downloaded jnlp file path>

   To run the downloaded .jnlp file with verbose tracing, perform the following steps:

   1. Enable tracing in the local JRE control panel. Go to Java Control Panel > Advanced > Debugging and select the Enable tracing option.
   2. Run the command: <JRE_HOME>/bin/javaws -verbose <downloaded jnlp file path>. Depending on the OS, find the logs in your local JRE directory.

   Note:

   • To use Java Web Start application with WebSphere® Application Server, you need to add the following system property in the WebSphere Application Server start up configuration.

     -Dyfs.jnlp.forceCookieVersionZero=true

   • The JNLP file that is downloaded for a logged-in user can only be used once before the HTTP session is logged out or times out. If the same JNLP is run more than once or it is run after the HTTP session is no longer valid, then an error is displayed by the Java Web Start Launcher. More information about the error can be seen in the ‘Details’ tab of the Java Web Start error prompt.
   Tip:

   • To enable server-side tracing for starting the Applications Manager or System Management Console using the Web Start Launcher from the Application Console UI, enable tracing for JSPs. For more information, see Trace components details screen
   • To enable server-side tracing for starting the Applications Manager from Business Center or System Management from System Administration Console by using the Web Start Launcher, you need to enable tracing for Web UI framework. For more information, see Enabling tracing for Web UI Framework.