Troubleshooting Enterprise PKS Management Console

Page last updated:

The following sections describe how to troubleshoot failures to deploy of the VMware Enterprise PKS Management Console appliance and of Enterprise PKS instances from the management console.

Deployment of the Enterprise PKS Management Console Appliance Fails

If the Enterprise PKS Management Console appliance fails to deploy from the OVA template, attempt the following steps.

  1. Use SSH to log in to the Enterprise PKS Management Console appliance VM as root user.
    Use the password that you specified when you deployed the OVA.
  2. Run the following command to obtain the server logs:

    journalctl -u pks-mgmt-server > server.log
    
  3. If the logs do not provide the solution, delete the appliance VM from vCenter Server and attempt to deploy it again.

Deployment of Enterprise PKS from the Management Console Fails

If Enterprise PKS fails to deploy from the management console, remove the failed deployment and attempt to deploy Enterprise PKS again.

Follow the procedure in Delete Your Enterprise PKS Deployment to cleanly remove all Enterprise PKS components from vSphere and to clean up related objects in the management console appliance.

Obtain the vRealize Log Insight Agent ID for Enterprise PKS Management Console

If you enabled integration with VMware vRealize Log Insight, Enterprise PKS Management Console generates a unique vRealize Log Insight agent ID for the appliance. You must provide this agent ID to vRealize Log Insight so that it can pull the appropriate logs from the appliance.

You obtain the vRealize Log Insight agent ID as follows:

  1. Use SSH to log in to the Enterprise PKS Management Console appliance VM as root user.
  2. Run the following command to obtain the ID:

    grep LOGINSIGHT_ID /etc/vmware/environment | cut -d= -f2
    

    The resulting ID will be similar to 59debec7-daba-4770-9d21-226ffd743843.

  3. Log in to the vRealize Log Insight Web user interface as administrator and add the agent ID to your list of agents.


Please send any feedback you have to pks-feedback@pivotal.io.