10.9. Administration Tools

10.9.1. I Cannot Log in to Oracle VDI Manager
10.9.2. I Cannot Log in to Oracle VDI Manager Running on Oracle Solaris 11 Using Firefox
10.9.3. I Get a Blank Screen After Successfully Logging in to Oracle VDI Manager
10.9.4. Error - "You Have Been Logged out Because a Consistent Response Could Not Be Guaranteed"
10.9.5. How Can I Change the Password of an Oracle VDI Host?
10.9.6. How Do I Change the Password of a Remote MySQL Database?
10.9.7. Does the MySQL Database Store All Sun Ray Software Configuration?
10.9.8. The vda Command Reports That Oracle VDI Is Not Running But Other Commands Say It Is
10.9.9. Users Do Not Show Up in Users and Groups in Oracle VDI Manager
10.9.10. Is There a Way to Modify the Cacao Logging Behavior So That a Long History Can Be Maintained?
10.9.11. Jobs Do Not Finish Even After You Cancel Them with Oracle VDI Manager
10.9.12. Can I Adjust the Logging Level for the Oracle VDI Logs?
10.9.13. How Do I Log in to the Embedded MySQL Server Database?

10.9.1. I Cannot Log in to Oracle VDI Manager

This is most likely an issue with Cacao or the Oracle VDI service

  1. If the Oracle VDI host runs into a virtual machine, check that the machine has enough RAM

  2. Check the status of Cacao and the Oracle VDI service as described in Section 10.10.2, “The System Is Not Reacting as Expected”.

  3. Try restarting the service:

    /opt/SUNWvda/sbin/vda-service restart

10.9.2. I Cannot Log in to Oracle VDI Manager Running on Oracle Solaris 11 Using Firefox

This is most likely an issue with Transport Layer Security (TLS) support in Firefox.

When you use Firefox to connect to Oracle VDI Manager running on Oracle Solaris 11, the browser reports the error code ssl_error_internal_error_alert. This is due to the fact that Oracle Solaris 11 uses TLS 1.1, which Firefox does not support yet.

  1. Disable TLS 1.0 in Firefox.

    To access this setting, open the Options window, select Advanced and then select the Encryption tab.

  2. Log in to Oracle VDI Manager.

    Firefox stores the server certificate and uses it for future connections.

  3. Once you have successfully logged in, you can reenable TLS 1.0 in Firefox.

10.9.3. I Get a Blank Screen After Successfully Logging in to Oracle VDI Manager

This is most likely an issue with the MySQL database

  1. Try restarting the service

    /opt/SUNWvda/sbin/vda-service restart
  2. If the problem persists, you need to troubleshoot the MySQL database:

    If you are using the embedded Oracle VDI MySQL Server database, it is important to know that the database is quite demanding regarding physical resources, this specifically concerns CPU power, RAM and network bandwidth. The first thing to check is always if the network connectivity is provided and that the database service is running.

    Run the following command to check if the embedded MySQL Server database master and slave (if configured) are running.

    /opt/SUNWvda/sbin/vda-db-status

    On Oracle Solaris platforms, you can also check the status of the database on the master or slave host with the following command:

    # svcs svc:/application/database/vdadb:default

    If everything is fine you should see something similar to this:

    STATE STIME FMRI
    online Mrz_18 svc:/application/database/vdadb:default

    If the database service is not running, start it.

    On Oracle Solaris platforms, use either of the following commands:

    # svcadm enable svc:/application/database/vdadb:default
    # svcadm clear svc:/application/database/vdadb:default

    On Linux platforms, use the following command:

    # /etc/init.d/vda-db-init start 

If none of this helps, check the MySQL log files for possible root causes for your database problems. The log files are located in /var/opt/SUNWvda/mysql. Information about the MySQL Cluster log file format can be found in the official MySQL documentation: MySQL Cluster Log Messages.

10.9.4. Error - "You Have Been Logged out Because a Consistent Response Could Not Be Guaranteed"

Refer to the Troubleshooting item Section 10.9.1, “I Cannot Log in to Oracle VDI Manager”.

10.9.5. How Can I Change the Password of an Oracle VDI Host?

If you need to change the root password of an Oracle VDI host, run the following UNIX command.

# passwd root
New Password: <enter new password>
Re-enter new Password: <confirm>

10.9.6. How Do I Change the Password of a Remote MySQL Database?

During the initial configuration of Oracle VDI (using an external database), an Oracle VDI database user account (default, vdadb) was created.

  1. Change the password on the MySQL side by using the following MySQL commands.

    mysql> UPDATE mysql.user SET password=PASSWORD('<new_password>') WHERE user='vdadb';
    mysql> FLUSH PRIVILEGES;
  2. To change the password on Oracle VDI, reconfigure Oracle VDI.

    See Section 2.3.4, “Removing a Host from an Oracle VDI Center”

10.9.7. Does the MySQL Database Store All Sun Ray Software Configuration?

No, the Sun Ray Software configuration is stored in an LDAP-based datastore.

10.9.8. The vda Command Reports That Oracle VDI Is Not Running But Other Commands Say It Is

Problem: You run the vda command and you see the error message, "This command cannot be used because Oracle Virtual Desktop Infrastructure is not running on this server". However when you run the vda-service status and vda-db-status commands, they show that Oracle VDI is running.

Solution: Check your /etc/hosts file to see if you have an IPv6 entry for localhost. If you have, comment out that entry and run the vda command again.

10.9.9. Users Do Not Show Up in Users and Groups in Oracle VDI Manager

It might be necessary to customize the LDAP filters ldap.user.object.filter and ldap.user.search.filter as described in Appendix C, User Directory LDAP Filters and Attributes, especially if the user directory is OpenLDAP or Novell eDirectory.

10.9.10. Is There a Way to Modify the Cacao Logging Behavior So That a Long History Can Be Maintained?

Yes. See Section 8.5.5, “Changing Logging for Oracle VDI”.

10.9.11. Jobs Do Not Finish Even After You Cancel Them with Oracle VDI Manager

You can force to abort all active jobs:

  1. Verify that the Oracle VDI service is running.

  2. Enter the following command in the shell:

    # /opt/SUNWvda/mysql/bin/mysql  \
    --defaults-file=/etc/opt/SUNWvda/my.cnf -D vda -u root -p -e "UPDATE \
    t_job SET status = 'CANCELED', endtime = NOW() \
    WHERE status IN ('RUNNING','QUEUED','CANCELLING') AND type <> 'DESTROY_POOL'" 
  3. If asked for a password, enter the MySQL database administrator password selected when you configured Oracle VDI on the primary host.

    If the administrator password was automatically generated, see Section 10.9.13, “How Do I Log in to the Embedded MySQL Server Database?”.

    If you are using a remote MySQL database, use the remote database administrator user and password.

10.9.12. Can I Adjust the Logging Level for the Oracle VDI Logs?

By default, all Oracle VDI service messages are logged in the Cacao log file. To change the logging level or the log history, see Section 8.5.4, “Checking the Oracle VDI Log Files”.

10.9.13. How Do I Log in to the Embedded MySQL Server Database?

Caution

Logging in to the Oracle VDI database in order to change settings and data is not supported. Only use the Oracle VDI administration tools to perform these tasks.

  1. Obtain the database password.

    When you configure the primary host in an Oracle VDI Center and you use the embedded MySQL Server database, you can either provide your own password for the database administrator or have a password automatically generated.

    To obtain the password, run the following command as root:

    # /opt/SUNWvda/sbin/vda-center getprops -s vda.password
    Caution

    The password is displayed in clear text. Ensure that no-one else can see your screen.

  2. Log in to the embedded Oracle VDI MySQL Server database.

    On the Oracle VDI host that has the master database, run the following command as root :

    # /opt/SUNWvda/mysql/bin/mysql --defaults-file=/etc/opt/SUNWvda/my.cnf \
    --host=localhost -u root -p

    When prompted, type the administrator password.