This section details Univiewer Console, Univiewer Web Console, and Univiewer Console Web start connection to UVMS, as well as telemetry management.
UVC can only be launched if the JAVA_HOME system environment variable is set to the bin directory containing the java executable.
Once Univiewer Web Console has been deployed, open UVC as follows:
The communication between the user’s computer and the Univiewer Web Console is in HTTP or HTTPS. The communication between the Univiewer Web Console and server components (UVMS, UJ, DUAS and Reporter) is proprietary.
For performance reasons, make sure the Web server is installed close to the server components.
To launch Univiewer Console Web Start from a remote Web browser, enter the appropriate URL to the Web browser:
For example
http://myserver.domain.com:8080/univiewer_console_webstart_v6.<m.bb>
The server name and port numbers must correspond to those provided in the uvc.jnlp file located in the application root directory.
When starting UVC from Web Start in Internet Explorer, the log file folder is located in the personal user folder (C:\Users\%userprofile%\univiewer_console\logs).
Java 11 does not support Web Start technology.
On the first connection, the Login window will require the following elements to determine the target UVMS and authenticate the user:
Login
Enter the UVMS login user account ("admin" by default):
Password
Enter the password provided during UVMS installation. The user name and password can only contain the following characters:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!#&'()+,-.:;>=<?@[]_{|}~
Management Server
Identifies the target UVMS: <node name> [<host name>:<port number>].
This history lists all the successful connections to the UVMS. It can be erased by clicking Advanced > Clear history.
Advanced
Allows the target UVMS to be changed.
SSL
Check this box to get an SSL encrypted communication between UVC and UVMS.
This is only possible if UVMS was configured to operate in SSL mode.
Hostname
The UVMS host name. Connection will fail if the UVMS is not started.
Port
Enter the port number that was validated during UVMS installation. By default :
Centralized User Preferences
Check this box to centralize in UVMS database (in addition to the local storage on this workstation) your user preferences from UVC Administration mode, your bookmarks and your lists filters. This way, if you use another workstation, you can recover your user preferences by checking this box the next time you log in. Several situations occur:
User preferences are stored locally in two files:
Click Connect to establish the connection or Exit to close the window without trying to connect.
If the connection cannot be established with the targeted UVMS, a message is displayed to inform the user. If several UVMS are declared in UVC, the message contains the list of target hosts: the user can then cancel the connection attempt. If the message windows is kept, the connection will be established automatically as soon as possible. The duration of a connection attempt with a host can be modified with the node setting UVMS_UVC_RECONNECTION_TIMER.
If the following message is displayed: "The telemetry settings are not configured. Please contact your administrator to proceed.", refer to section Telemetry.
By default, the data specified at the first connection is stored in connection history (locally on the user’s workstation) in the following directory:
By default, UVC uses the user.home java variable to determine the directory for storing user preferences in Univiewer Console.
To change this default directory, the uphd variable should be valued with the directory name where UVC creates a univiewer_console subdirectory containing user preferences.
This directory can contain system variables enclosed in $ characters.
On Windows, a \ character must be doubled: \\.
Examples:
uphd=$HOMEPATH$
uphd=Z:\\users\\$USERNAME$
<property name="uphd" value="Z:\\users\\$USERNAME$"/>
Refer to one of the following paragraphs below (according to the UVC installation mode) to determine the method of setting this variable.
UVC standalone: The administrator can create a file named uphd.properties in the Univiewer Console data sub-directory. This file must respect the following syntax:
uphd=<directory>
The uphd.properties file is kept by a UVC upgrade. If this file is missing or contains incorrect syntax, the default directory is used.
UVC Web Console: The WEB-INF\conf\UVC_config.properties file must be modified by adding the following line:
uphd=<directory>
UVC Web Start: The .jnlp doit file must be modified by adding the following line:
<property name="uphd" value="directory"/>
User preferences group:
User preferences are stored locally to UVC (in the directory described above) in two files:
User preferences can be centralized into UVMS at the user's request when connecting to UVC, according to the rules described in the section Connection Parametersabove.
If user preferences are centralized, they are saved locally and into UVMS as soon as the change is saved. If the connection to UVMS is temporally impossible, when reconnecting, the user will have to manually register any user preference (preference, bookmark or filter) so that the pending preferences are saved.
UVMS commands are available to act upon user preferences centralized in UVMS: delete, import and export. Refer to section User Preferences.
By default, the Univiewer Console connects to the requested UVMS node.
If the node is not accessible in a UVMS failover, UVC can be automatically connected to the available UVMS node.
For this the following configuration must be performed (only once). In the UVC login window:
By performing this configuration, the Univiewer Console now recognizes all the failover nodes.
As of version 6.10.41, documentation new updates are posted on the Broadcom Techdocs Portal.
Look for Dollar Universe.