macOS Troubleshooting

macOS Installer References

Installation errors will be displayed on the devices and recorded in the macOS logs. To troubleshoot installer problems, go to the device with the failed installation and check the orbitalupdater.log, for the cause of the failure. This can be done using the Log Reports viewer in the Console application.

Orbital Installation Failed

Symptoms

Things to Check

  • Check the detailed install logs on your device, as they may show that the installation failed because the service did not start. View the orbitalupdater.log from the Log Reports viewer in the Console app.

Troubleshooting Tools

Various tools exist to help gather more information and troubleshoot customer issues with Orbital.

Logs

If an error or warning occurs, check the logs first.

  • Secure Endpoint Connector Logs (See above)

  • Orbital Logs

  • Viewable in Diagnostics bundle or this terminal command on the device: log show --predicate 'subsystem == "com.cisco.endpoint.orbital"'

Secure Endpoint Diagnostics

These items in a remote Diagnostics bundle from the Secure Endpoint Console can help troubleshoot Orbital:

  • List of all packages installed on the device: pkgutil_info.txt

The macOS node package is com.cisco.endpoint.orbital.app.

  • Orbital installation/update logs: orbitalupdater.log.

  • Logs written by the Orbital node service: Orbital.log.

 

More Info