GUI Troubleshooting

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English


Copyright © SEP AG 1999-2021. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo V2. For previous documentation version(s), check documentation archive.


Graphical User Interface (GUI) problems

After updating SEP sesam on Windows, GUI cannot be opened

Problem

  • After updating SEP sesam to version ≥ 4.4.3.82 Beefalo V2 on Windows, GUI cannot be opened when the group policy option Prevent access to registry editing tools is applied.

Possible cause

  • This issue seems to be related to the group policy (GPO) setting: if Prevent access to registry editing tools is applied for a specific user or group, opening the GUI does not work for the users which are prevented from accessing the Registry. In most cases, users with admin privileges will still be able to run the GUI as they are typically exempt for a GPO (and are able to access the Registry). If this policy is disabled (or not configured), the users may access the GUI regardless of their privileges.

Solution

  • To enable access to the GUI for the affected users (typically non-admin users), disable the group policy option Prevent access to registry editing tools.
  • SEP Warning.png Warning
    Only experts should edit the registry; modifying Windows Registry incorrectly might crash your Windows operating system causing data loss.
    1. Press the Windows key + R to open the Run window.
    2. Type gpedit.msc and press Enter.
    3. In the Group Policy Editor -> User Configuration -> Administrative Templates -> System, double-click on Prevent access to registry editing tools setting in the right panel and select Disable. Then click Apply.

After updating a GUI client, SEP sesam GUI does not display correctly

Problem

Cause

  • If you have custumized SEP sesam GUI according to your needs (e.g., changed font, appearance of GUI tables, etc.), GUI might not display properly after update.

Solution

  • Under the Configuration -> Defaults -> Fonts and Tables, reset GUI to SEP sesam default.

GUI Server not accessible

Problem

  • SEP sesam cannot access the GUI Server.

Possible causes

  • The network connection to SEP sesam is broken.
  • The GUI Server process is not running.

Solution

  • Make sure that the computer is running.
  • Start the GUI server process by running the command sm main reload rmi.

Database connection failure

Problem

  • SEP sesam cannot connect to the database.

Possible causes

  • The DB or RMI servers are not running.

Solution

  • Run the commands sm main reload db or sm main reload rmi to restart the servers.

GUI does not start

Problem

  • The Graphical User Interface (GUI) fails to start.

Possible causes

  • There is a problem with Java rights.
  • The entry for the computer in sm java.policy is missing. For example:
// NET
permission java.net.SocketPermission "'mypcname:*"',
"'connect,accept,resolve"';
  • A problem with the screen resolution.

Solution

  • In case of the screen resolution problem, set a resolution to at least 1920x1080 (full HD).

After updating Java from v. 6 to v. 7, the SEP sesam Server does not start

Problem

  • The SEP sesam Server does not start after updating Java installation from major version 6 to version 7. This mostly concerns customers with SEP sesam installations on Windows based operating systems.

Possible causes

  • The SEP sesam Server configuration file <sesam_install_dir>\var\ini\sm.ini includes a configuration section which initializes the path to the JRE virtual machine detected during installation of SEP sesam:
[JAVA]
java_exit_on_fail=no
java_interpreter=C:\Program Files\Java\jre6\bin\java 

After the update from JRE 6 to JRE 7, the configured path is not present on the system anymore.

Solution

  • Edit the configuration file <sesam_install_dir>\var\ini\sm.ini.
  • Typically, the path is C:\Program Files\Java\jre7\bin\java.
  • Change the configuration file as follows:
[JAVA]
java_exit_on_fail=no
java_interpreter=C:\Program Files\Java\jre7\bin\java 

Once you modified the configuration file and saved the changes, you should be able to start SEP sesam service.

  • You should also check the JRE installation path, specified in the SEP sesam GUI properties in the Start menu and in the shortcut on desktop, as shown in the screenshot below.

Jreupdate.jpg

SEP sesam RMI (GUI) Server does not start up after update to Java 7 update 51

Problem

  • The SEP sesam GUI does not start after updating to Java version 7 update 51 (full version: 1.7.0_51-b13).

Possible causes

Solution

  • Open the file <SESAM_ROOT>/var/ini/sm_java.policy.
  • Go to section
 // NET
 permission java.net.SocketPermission "*:*", "connect,resolve";
 permission java.net.SocketPermission "*:11301", "connect,accept,resolve";
 permission java.net.SocketPermission "*:11401", "connect,accept,resolve";
 permission java.net.SocketPermission "*:21", "connect,accept,resolve";
  • Change the line
permission java.net.SocketPermission "*:11401", "connect,accept,resolve";

to

permission java.net.SocketPermission "*:11401", "connect,accept,resolve,listen";

Solution for new SEP sesam Server installations

  • Completely uninstall SEP sesam Server.
  • Completely uninstall Java JRE 7u51.
  • Download an older Java JRE version (for example, Java JRE 7u45) from the Java Download Archive.
  • Install an older Java JRE Version (for example: Java JRE 7u45).
  • Install SEP sesam Server.

Cannot read or write to the working directory

Problem

  • There is a problem with reading or writing to the working directory.

Possible causes

  • The entry for the working directory in sm java.policy is missing.
Windows example
// FILE
permission java.io.FilePermission
"'D:nsesamnvarn-"', "'read,write"';
Linux/Unix/Tru64 example
// FILE
permission java.io.FilePermission
"'/sesam/var/-"', "'read,write"';

Solution

Online guide not available

Problem

  • The online guide cannot be accessed.

Possible causes

  • Adobe Acrobat Reader is not installed.
  • Adobe Acrobat Reader is installed but not configured in the GUI.
  • The PDF file is not configured in the GUI.

Solution

Online help not available

Problem

  • The online help cannot be accessed.

Possible causes

  • There is no browser installed on the system.
  • The browser is installed but not configured in the GUI.
  • The HTML help file is not configured in the GUI.

Solution

  • Install a browser.
SEP Tip.png Tip
  • Access rights for missing computers can be entered on the server side java policy file by running sm_setup allow_gui {host} {user}.
  • It is not necessary to restart the GUI Server after making changes to the sm_java.policy. The refresh is explicitely allowed in sm_java.policy with entry permission java.security.SecurityPermission "getPolicy";.
  • The syntax for pathnames in the sm java.policy is platform dependent.
  • To test for problems with Java security, the line permission java.security.AllPermission; can be un-commented by remove leading '//'. This command removes the restriction to explicitly specified rights and switches it off . To avoid security holes, this line should be commented out after the test (i.e. add the prefix '//‘)!

See also

GUI