9.8. Administration Tools

9.8.1. I Cannot Log in to Oracle VDI Manager
9.8.2. I Get a Blank Screen After Successfully Logging into the Oracle VDI Manager
9.8.3. Error - "You Have Been Logged out Because a Consistent Response Could Not Be Guaranteed"
9.8.4. How Can I Change the Password of an Oracle VDI Host?
9.8.5. How Do I Change the Password of a Remote MySQL Database?
9.8.6. Does the MySQL Database Store All Sun Ray Software Configuration?
9.8.7. The vda Command Reports That Oracle VDI Is Not Running But Other Commands Say It Is
9.8.8. Users Do Not Show Up in Users and Groups in Oracle VDI Manager
9.8.9. Is There a Way to Modify the Cacao Logging Behavior So That a Long History Can Be Maintained?
9.8.10. Jobs Do Not Finish Even After You Cancel Them with Oracle VDI Manager
9.8.11. Can I Adjust the Logging Level for the Oracle VDI Logs?
9.8.12. How Do I Log in to the Embedded MySQL Server Database?

9.8.1. I Cannot Log in to Oracle VDI Manager

This is most likely an issue with cacao or the vda 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 vda service as described in Section 9.9.2, “The System Is Not Reacting as Expected”.

  3. Try restarting the service:

    /opt/SUNWvda/sbin/vda-service restart

9.8.2. I Get a Blank Screen After Successfully Logging into the 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 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 that 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 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.

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

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

9.8.4. 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>

9.8.5. 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 CLI 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, “Reconfiguring Oracle VDI on a Host”

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

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

9.8.7. 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 cacaoadm 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.

9.8.8. 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.

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

Yes. See Section 8.3.3, “How to Change Logging for Oracle VDI”.

9.8.10. 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 9.8.12, “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.

9.8.11. 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.3.2, “How to Check the Oracle VDI Log Files”.

9.8.12. 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 or slave database, run the following command as root :

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

    When prompted, type the administrator password.