Starting an Web-Based LSMS GUI Session

The LSMS offers, as the optional IP User Interface feature, a web-based graphical user interface (GUI) intended for remote users. The web-based GUI can be run:

On a PC with Microsoft® Windows installed, using Microsoft Internet Explorer (version 8.0, 9.0, 10.0, or 11.0)
A 32-bit installation of Windows uses 32-bit Internet Explorer and 32-bit Java. A 64-bit installation of Windows includes both the 32-bit and 64-bit Internet Explorer. If you are using the 32-bit Internet Explorer, 32-bit Java is required, and if you are using the 64-bit Internet Explorer, 64-bit Java is required. You can check the Internet Explorer version by clicking on Tools > About Internet Explorer. If 64-bit Edition is displayed as shown in the following example, you are using the 64-bit edition. If 64-bit Edition is not displayed, you are using the 32-bit edition.

Figure 1. About Internet Explorer
On a Linux workstation, using Mozilla® Firefox® 3.0.0 or later

The web-based GUI is accessible from any machine that can access the network on which the LSMS resides. The functionality of the web-based GUI is the same as that of the server-side GUI.

Note: When you have completed logging into thea web-based LSMS GUI, the session has these operating characteristics:

Pressing the Back button from the browser from which the GUI was launched terminates that GUI session. To reopen the GUI, you must click the Refresh button and begin the login process again.
Pressing the Refresh button from the browser from which the GUI was launched terminates that GUI session. To reopen the GUI, you must begin the login process again.
You cannot use a browser window that was started by selecting File > New > Window from the browser window to launch another web-based LSMS GUI session.
If the GUI is idle for an extended period, you may receive Server not responding or Invalid Session ID errors; close the existing GUI session and start a new GUI session.

The HTTPS support on LSMS feature allows you to configure the protocol(s) used for the GUI:

Secure Hypertext Transfer Protocol (HTTPS)
Hypertext Transfer Protocol (HTTP)
Both HTTPS and HTTP

Both HTTPS and HTTP are enabled by default. HTTPS supports encryption of data exchanged between the web server and the browser, thus facilitating data privacy. HTTP is not encrypted/secure, allowing data to be captured by any network analyzer and viewed.

A script (/usr/TKLC/lsms/bin/httpConfig.pl) is provided to toggle between protocols or to check what is currently enabled. The script can be run by the lsmsadm user with one of the following parameters:

https: Results in HTTPS being enabled and HTTP being disabled.
http: Results in HTTP being enabled and HTTPS being disabled.
both: Results in both HTTPS and HTTP being enabled. This is the default.
status: Displays whether HTTPS and HTTP are enabled or disabled.

Note: After changing the protocol, the GUI must be refreshed to reflect the changes. A GUI notification will be displayed.

To start the web-based GUIverify that the IP User Interface feature has been activated and, perform the following procedure:

Start your web browser (Mozilla® Firefox® or Internet Explorer).
Specify https or http followed by the LSMS Virtual IP (VIP) address in the Location: or Address: field, or the application VIP in a segmented network. For http, add :8200.
- https://<VIP_address>
- http://<VIP_address>:8200
The <VIP_address> is the Virtual IP address used by your LSMS system. (The VIP address is always associated with the active server; when switchover occurs, the VIP address association is switched over from previously active server to the newly active server.)
Press Return and the Oracle Communications LSMS start page is displayed.
Note: If using HTTPS, you must click through some security warnings that are displayed, which differ depending on the browser in use:
- For Internet Explorer, click on Continue to this website (not recommended) on the following screen:
  Figure 2. Problem with Security Certificate
- For Mozilla Firefox, click on I Understand the Risks on the following screen:
  Figure 3. Connection is Untrusted
  
  Then click on Add Exception on the following screen:
  
  Figure 4. Connection is Untrusted (continued)
  
  Then enter the site in the Location field and click on Confirm Security Exception:
  
  Figure 5. Add Exception for Untrusted Connection
The Oracle Communications LSMS start page displays:

Figure 6. Oracle Communications LSMS Start Page
If you are logging in for the first time from this terminal, click the Java Setup button and follow the instructions on the displayed page to install a Java plug-in and set up a security policy.
Otherwise, go to step 5.
Open the Java Control Panel for your terminal, go to the Security tab as shown in Figure 7, and click on Edit Site List.
Note:
- The actual screens displayed might differ from these examples depending upon the specific Java version in use.
- If using both https and http, both must be added to the exception site list (https://<VIP_address> and http://<VIP_address>:8200).
Figure 7. Security Tab of Java Control Panel
After clicking on Edit Site List, click on Add:
Figure 8. Adding to the Exception Site List
Type in the location of your LSMS server (https://IP_address or http://IP_address:8200):
Figure 9. Adding the LSMS Server to the Exception Site List
Click OK.
The Security tab will now show the server in the Exception Site List, as shown in the following example:
Figure 10. Exception Site List Including the LSMS Server

Note: If you are adding an http site, a warning similar to the following warning is displayed:
Figure 11. Security Warning for HTTP Location

Click Continue to add the server to the Exception Site List.
Click OK to exit the Java Control Panel and return to the GUI.
If using HTTPS and Internet Explorer, install the security certificate as follows. Otherwise, go to step 11.
1. Back at the Oracle Communications LSMS Start Page, click on Certificate error at the right of the address bar, and then click on View certificates in the popup window titled Certificate Invalid.
  Figure 12. Certificate Error
  
  The Certificate screen is displayed:
  Figure 13. Certificate Screen
2. Click on Install Certificate.
  The Certificate Import Wizard opens:
  Figure 14. Certificate Import Wizard
3. Click on Next >, and then select the radio button to Place all certificates in the following store:
  Figure 15. Certificate Import Wizard (continued)
4. Click on Browse to go to the Select Certificate Store window, and select Trusted Root Certification Authorities:
  Figure 16. Select Certificate Store
5. Click OK and Next, and verify the settings:
  Figure 17. Completing the Certificate Import Wizard
6. Click Finish, and then verify that you want to install the certificate:
  Figure 18. Certificate Installation Security Warning
7. Click Yes to import the certificate:
  Figure 19. Certificate Import Successful
8. Click OK, and then OK again to exit the Certificate window.
9. Restart Internet Explorer.
Back at the Oracle Communications LSMS Start Page, click on the Web Interface button.
Note: If using HTTPS, click Yes and then Continue for the following security warnings:
Figure 20. Insecure Content Warning

Figure 21. Untrusted Website Warning
Check the box to accept the risk to run the application, and click Run:

Figure 22. Application Security Warning

The LSMS Web GUI Start Page displays:
Figure 23. LSMS Web GUI Start Page with Login Button
Click the Login button.
The LSMS Login screen appears. From this point on, the web-based GUI works exactly like the server-side GUI. Next, perform the procedure described in “Logging Into the LSMS Console Window”.
Figure 24. LSMS Welcome/Login Window

Note: If you log out of this web-based LSMS GUI session, you must start a new browser to log back in. If you only want to change user, select User/Session>Change User from the main LSMS menu.