Troubleshooting Windows Cells

This topic describes how to troubleshoot Windows cells deployed by Pivotal Cloud Foundry (PCF) Runtime for Windows.

Retrieve Logs

Perform the following steps to retrieve the logs for the Windows cell:

  1. Navigate to the Ops Manager Installation Dashboard.
  2. Click the PCF Runtime for Windows tile.
  3. Click the Status tab.
  4. Under the Logs column, click the download icon for the Windows cell you want to retrieve logs from.
  5. Click the Logs tab.
  6. When the logs are ready, click the filename to download them.
  7. Unzip the file to examine the contents. Each component on the cell has its own logs directory:
    • /consul_agent_windows/
    • /garden-windows/
    • /metron_agent_windows/
    • /rep_windows/

Connect to the Windows Cell

Perform the following steps to connect to your Windows cell to run diagnostics:

  1. Download and install a Remote Desktop Protocol (RDP) client.

    • For Mac OS X, download the Microsoft Remote Desktop app from the Mac App Store.
    • For Windows, download the Microsoft Remote Desktop app from Microsoft.
    • For Linux/UNIX, download a RDP client like rdesktop.
  2. Follow the steps in the Log into BOSH section of the Advanced Troubleshooting with the BOSH CLI topic to target and log in to your BOSH Director. The steps vary slightly depending on whether your PCF deployment uses internal authentication or an external user store.

  3. Retrieve the IP address of your Windows cell using one of the following methods.

    • If you use BOSH CLI v1, run the following command:

      $ bosh vms garden-windows
      Acting as user 'director' on deployment 'garden-windows' on 'p-bosh-1170e9b438cb29ff7c63'
      Director task 274
      Task 274 done
      | VM                                                    | State   | AZ      | VM Type | IPs          |
      | cell_windows/0 (03e221b3-3222-5e1e-eedd-b92221ff88e1) | running | default | xlarge  | |

      VMs total: 1

    • If you use BOSH CLI v2, run the following command, replacing MY-ENV with the alias you assigned to your BOSH Director:

      $ bosh -e MY-ENV -d garden-windows
      Using environment 'DIRECTOR-IP' as client 'admin'

      Name Release(s) Stemcell(s) Team(s) Cloud Config garden-windows ... ... - latest

  4. Retrieve the Administrator password for your Windows cell by following the steps for your IaaS:

    • On vSphere, this is the value of WINDOWS_PASSWORD in the consumer-vars.yml file you used to previously build a stemcell.
    • On Amazon Web Services (AWS), navigate to the AWS EC2 console. Right-click on your Windows cell and select Get Windows Password from the drop-down menu. Provide the local path to the ops_mgr.pem private key file you used when installing Ops Manager and click Decrypt password to obtain the Administrator password for your Windows cell.
    • On Google Cloud Platform (GCP), navigate to the Compute Engine Dashboard. Under VM Instances, select the instance of the Windows VM. At the top of the page, click on Create or reset Windows password. When prompted, enter “Administrator” under Username and click Set. You will receive a one-time password for the Windows cell.
    • You cannot RDP into Windows cells on Azure.
  5. Open your RDP client. The examples below use the Microsoft Remote Desktop app.

  6. Click New and enter your connection information: Rdp connect

    • Connection name: Enter a name for this connection.
    • PC name: Enter the IP address of your Windows cell.
    • User name: Enter Administrator.
    • Password: Enter the password of your Windows cell that you obtained above.
  7. To mount a directory on your local machine as a drive in the Windows cell, perform the following steps:

    1. From the same Edit Remote Desktops window as above, click Redirection.
    2. Click the plus icon at the bottom left. Rdp redirection
    3. For Name, enter the name of the drive as it will appear in the Windows cell. For Path, enter the path of the local directory.
    4. Click OK.
  8. Close the Edit Remote Desktops window and double-click the newly added connection under My Desktops to open a RDP connection to the Windows cell.

  9. In the RDP session, you can use the Consul CLI to diagnose problems with your Windows cell.

Consul CLI

Perform the following steps to use the Consul CLI on your Windows cell to diagnose problems with your Consul cluster:

  1. In your RDP session, open a PowerShell window.
  2. Change into the directory that contains the Consul CLI binary:
    PS C:\Users\Administrator> cd C:\var\vcap\packages\consul-windows\bin\ 
  3. Use the Consul CLI to list the members of your Consul cluster:
    PS C:\Users\Administrator\var\vcap\packages\consul-windows\bin> .\consul.exe members
    Node                       Address          Status  Type    Build  Protocol  DC
    cell-windows-0     alive   client  0.6.4  2         dc1
    cloud-controller-0   alive   client  0.6.4  2         dc1
    cloud-controller-worker-0   alive   client  0.6.4  2         dc1
    consul-server-0     alive   server  0.6.4  2         dc1
    diego-brain-0      alive   client  0.6.4  2         dc1
    diego-cell-0       alive   client  0.6.4  2         dc1
    diego-cell-1       alive   client  0.6.4  2         dc1
    diego-cell-2       alive   client  0.6.4  2         dc1
    diego-database-0    alive   client  0.6.4  2         dc1
    ha-proxy-0         alive   client  0.6.4  2         dc1
    nfs-server-0       alive   client  0.6.4  2         dc1
    router-0           alive   client  0.6.4  2         dc1
    uaa-0               alive   client  0.6.4  2         dc1
  4. Examine the output to ensure that the cell-windows-0 service is registered in the Consul cluster and is alive. Otherwise, your Windows cell cannot communicate with your PCF deployment and developers cannot push .NET apps to the Windows cell. Check the configuration of your Consul cluster, and ensure that your certificates are not missing or misconfigured.
Create a pull request or raise an issue on the source for this page in GitHub