Lab 2: Gather Horizon Agent Logs

Objective and Tasks
In this lab, you gather Horizon Agent logs directly from the Horizon Agent VM and the Horizon Connection Server:

  1. Connect to a Horizon Desktop
  2. Gather Horizon Agent Logs Directly From the Guest Virtual Machine
  3. Verify Horizon Agent Logs Collected from Guest Virtual Machine
  4. Gather Horizon Agent Logs from the Horizon Connection Server
  5. Verify Horizon Agent Logs Collected from the Horizon Connection Server
Task 1: Connect to a Horizon Desktop

In this task, you establish a connection to a Horizon Desktop.

  1. From the ControlCenter Server,
  2. Launch Omnissa Horizon Client
  3. Double-Click horizon-01a.techseals.co
  4. Double-Click to connect to W11-INST pool
    • Note: The W11-INST pool takes 2-3 minutes to load.
Task 2: Gather Horizon Agent Logs Directly From the Guest Virtual Machine

In this task, you collect Horizon Agent logs from the guest virtual machine you are connected to.

  1. After you are logged in to the  W11-INST VM open a command prompt.
  2. To navigate to the root, enter the command:
    • cd /
  3. To navigate to the DCT folder, enter the command:
    • cd "Program Files\Omnissa\Horizon\Agent\DCT"
  4. To generate a log bundle, enter the command:
    • support.bat
  5. The logs can take several minutes to generate.
    • NOTE: You might have to press Enter several times if your log collection appears to be frozen
  6. When prompted Do You want to collect logs for last few days only? [y/N]
    • Type y press enter
  7. When prompted Enter the number of days to the log (1 - 180)
    • Type 2 and press enter
  8. When prompted to dump the files, enter N.
Task 3: Verify Horizon Agent Logs Collected from Guest Virtual Machine

In this task, you locate and review the Horizon Agent Logs collected from the guest virtual machine.

  1. In the W11-INST connection desktop, locate the log bundle file.
  2. The file is on the desktop in a folder called horizon-sdtc.
  3. Double-click the horizon-sdct folder. The ZIP file is located in this folder.
    • Right-click the ZIP file and select Extract All.
    • Select Extract
  4. Open the unzipped log bundle and navigate to:
    • horizon-logs
  5. Open the latest debug.txt file.
  6. Verify that the first line of the log file confirms that the file is the Omnissa Horizon Agent logs:
    • Scroll to the bottom of the log file.
    • Search for the keyword hostname and verify that the name of the VM you are connected to.
    • NOTE:- You would also see the hostname of the parent image which is expected because at a point when VM was going through customizations, it would have got the hostname from the golden image but later it was changed to the name of the VM
Task 4: Gather Horizon Agent Logs from the Horizon Connection Server

In this task, you collect the Horizon Agent Logs from Connection Server.

  1. From the ControlCenter Server, open a new Chrome tab and click the Horizon-01a bookmark.
  2. Log in to the Horizon Connection Server Horizon-01a admin console.
    • User name: administrator
    • Password: Pa$$w0rd
  3. In Horizon Console, navigate to Settings>Administrators>Role Privileges>Add Role
  4. Create a  custom role
    • Click on Add and name it LogCollection
    • Select Collect Operation Logs privilege from the list
    • Click OK
    • NOTE: This custom role is a prerequisites to collect the logs from Horizon Console
  5. Add this role to the administrators permissions.
  6. In Horizon Console, navigate to Settings>Administrators>Administrators and Groups
    • Add LogCollection role to the administrators permissions
    • Click ADD PERMISSIONS and select LogCollection role and click FINISH
    • NOTE: you can ignore the error "Not all Permissions were successfully created. Root access group may already contain the same permission(s) or permission(s) already exists".
  7. Logoff and Login back to Horizon Admin Console of horizon-01a.techseals.co
    • User name: administrator
    • Password: Pa$$w0rd
  8. In Horizon Console, navigate to Troubleshooting>Log Collection>Collect
  9. From the dropdown Select Agent and under Select Pool, Click W11-INST and Click Search
  10. Select any one of the Virtual Machine and Click on Collect
  11. Click OK
  12. Note: Log collection takes around 10 to 12 minutes.
  13. To download and manage collected logs, select the Manage tab.
    • The Log Collection Status window lists the selected components and the log collection task status for each component. Status includes successfully queued logs and failures due to an error. You can refresh the list to see status updates.
  14. Download a log bundle to the users local file system, click the link under the Download column for that log collection task.

0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.