Access the system management console using Java Web Start Launcher

This topic describes how to launch the System Management Console 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

When you access the system management console, ensure you have enough memory, and that the Applications Manager is not open. It is recommended that you increase the memory available to the Java plug-in for every computer that runs the System Management Console. To increase the memory available, open the Java plug-in settings from the Windows control panel. Specify the following Java runtime parameters: -Xms128M -Xmx128m.

To access the System Management console:

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 Application Platform is installed.
    • portnumber is the listening port of the computer where Sterling Order Management System Software Application Platform is installed.

      The browser displays the Sign In window.

  3. Enter your login ID and password and click Sign In. The Application Console Home Page is displayed.
  4. From the menu bar, go to System > Launch System Management.
    The browser prompts you to take an action on the launchsystemmanager.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 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 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.
    Alternatively, you can launch the system management console by logging into 
    http://<IP_Address>:<Port_No>/sma/sma/console/login.jsp
    and follow steps 2 and 3. The lanuchsmasystemmanager.jnlp file will be downloaded. However, rest of the procedure remains the same.
    Note: The Application Console can be launched only with Microsoft Internet Explorer.
    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.