4.2. Admin GUI Issues

4.2.1. Unable to log in to Admin GUI after upgrade (Oracle Linux)

If you enabled Admin GUI access for additional UNIX users beyond the default admin account, access for those users is not preserved during an upgrade. The Sun Ray Software upgrade program does not preserve PAM configurations, and it reconfigures the default setting for admin during the upgrade.

Workaround: Modify the PAM configuration as follows based on the operating system running on the Sun Ray server:

  • For Oracle Linux, modify the /etc/pam.d/utadmingui file by replacing the current utadmingui PAM stack with the following auth include system-auth entry:

    #%PAM-1.0
    # BEGIN: added to utadmingui by SunRay Server Software -- utadmingui
    auth include system-auth
    # END: added to utadmingui by SunRay Server Software -- utadmingui 
  • For Oracle Solaris, modify the /etc/pam.conf file by replacing the current utadmingui PAM stack with the following entries:

    # BEGIN: added to utadmingui by SunRay Server Software -- utadmingui
    utadmingui auth requisite pam_authtok_get.so.1
    utadmingui auth required pam_dhkeys.so.1
    utadmingui auth required pam_unix_cred.so.1
    utadmingui auth required pam_unix_auth.so.1

Reference: CR 14340529

4.2.2. Multiple authentication (Solaris)

Sometimes, multiple authentications are required when the session is disconnected using a hot key sequence (the default is Shift-Pause).

Reference: CR 12249130

4.2.3. Admin GUI Upgrade

Due to changes with the Admin GUI, Apache Tomcat 5.5 (or higher) has to be installed on the system, and the utconfig script was extended to ask for the location of an existing Tomcat instance.

If you perform an upgrade from a previous Sun Ray Software version when using a preserve file, you must run utconfig -w after completing the upgrade. The utconfig -w command will prompt you for the Admin GUI settings, including the location of the Tomcat installation, and the Admin GUI will be started automatically.

Reference: CR 12204639

4.2.4. Self-Registration GUI

If the wrong username or password is entered, the self-registration GUI does not allow text to be entered.

Workaround: Press the Exit button to relaunch the self-registration GUI.

Occasionally, use of the self-registration GUI can result in a Java core dump, although registration continues to work as expected, and no other adverse side effects are observed. However, if coreadm is configured to name core dumps uniquely, disk space usage should be monitored.

Reference: CRs 12195258, 12196361