Skip to main content

Illumio Core 24.5 Install, Configure, Upgrade

VEN Installation Troubleshooting

This topic provides information about troubleshooting VEN installation issues you might encounter when using the PCE web console. For general troubleshooting, see "VEN Troubleshooting" in VEN Administration Guide.

Troubleshoot Pairing Errors

If you execute the pairing script and it fails, the system displays an error message indicating failure. One such error may be:

Unable to retrieve Illumio VEN configuration from management server 
illumio.example.com:8443 in a timely fashion.

If the script fails to install the VEN, the following output displays:

Pairing Status
             --------------
Secureware Package installation ......SUCCESS
Pairing Configuration exists .........SUCCESS
VEN Manager Daemon running ...........SUCCESS
Master Configuration retrieval .......SUCCESS
VEN Configuration retrieval ..........FAILED
2014-01-23T18:43:50Z AgentManager 13088
Verify activation code and retry pairing
Workload has FAILED pairing with Illumio
Possible Causes of Failure

Failures may be caused by a problem with the VEN communicating with PCE, or by exceeding the hard license limit, or by an attempt to install an Endpoint VEN or Server VEN on an operating system that doesn't support that VEN type.

  • The hard license limit has been exceeded.

  • An invalid pairing profile is being used.

  • The wrong pairing script was copied and run on the workload.

  • In the pairing script section, the pairing profile contains invalid pairing keys.

  • The pairing profile was disabled.

  • The use limit for the pairing key has been exceeded.

  • The pairing key has expired.

  • Wrong Enforcement Node Type setting (Servers & Endponts > Pairing Profiles):

    • The pairing profile is for a server node (not an endpoint node) but the profile includes the parameter -endpoint true.

    • The pairing profile used to activate a macOS VEN is set to Server VEN.

    • The pairing profile used to activate a Linux VEN is set to Endpoint VEN.

Remediate

  • Check the pairing profile in the PCE web console to try to verify the cause of the failure.

  • Check the PCE Logs and VEN Logs.

  • The VEN Library is available in the PCE web console. You can download VEN software bundle and also view the dependencies and supported OS versions.