Launching the Applications Manager using Java Web Start Launcher

You can launch the Applications Manager by using the Java™ Web Start Launcher.

Before you begin

  • Java 1.7 or above should be installed on the system.
  • Java cache should be enabled in Java Control Panel.

About this task

To access the Applications Manager:

Procedure

  1. Set the yfs.yfs.configurator.usewebstart property to true in the customer_overrides.properties file.
  2. Point your browser to http://<hostname>:<portname>/smcfs/console/start.jsp

    where,

    • hostname is the computer name or IP address of the computer where Sterling Order Management System Software is installed.
    • portnumber is the listening port of the computer where Sterling Order Management System Software is installed.

      The browser displays the Sign In window.

  3. Enter your login ID and password and choose the Sign In button. The Console Home Page is displayed.
  4. From the menu bar, choose Configuration > Launch Applications Manager.
    The browser prompts you to take an action on the launchapplicationmanager.jnlp file. You can perform one of the following actions:
    • 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.
    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 launch 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 Webphere 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.
    Note: The Application Console can be launched only with Microsoft Internet Explorer.



    Additionally, enterprise users who maintain an enterprise can access the Applications Manager by means of http://<Sterling Order Management System Software installation server>/smcfs/console/login.jsp.

    Tip:
    • To enable server-side tracing for launching 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 launching the Applications Manager from Sterling Business Center or System Management from System Administration Console using the Web Start Launcher, you need to enable tracing for Web UI framework. For more information, see Enabling tracing for Web UI Framework.