Tips for finding Knowledge Articles

  • - Enter just a few key words related to your question or problem
  • - Add Key words to refine your search as necessary
  • - Do not use punctuation
  • - Search is not case sensitive
  • - Avoid non-descriptive filler words like "how", "the", "what", etc.
  • - If you do not find what you are looking for the first time,reduce the number of key words you enter and try searching again.
  • - Minimum supported Internet Explorer version is IE9
Home  >

KB-7334: Upgrading the Centrify agent for Mac

Mac & PC Management Service ,  

15 August,16 at 05:14 PM

Applies to: Centrify Identity Service, Mac Edition


Our organization is looking for information on upgrading our Mac computers to the latest version of Centrify. Are there any recommended steps to follow to ensure a smooth upgrade?


In most cases, you can update agents on Mac OS X computers by simply installing the new agent either directly or remotely on top of an existing agent.

Note: Always install the latest Centrify agent for Mac prior to any OS version updates (example: performing upgrade from El Capitan 10.11 to Sierra 10.12)

As a best practice, you should perform in-place upgrades using a local Mac administrative (admin) account or any other user account that has local administrative rights and reboot the computer after completing the upgrade. In most cases, you should not perform the upgrade while you are logged on as an Active Directory user in a currently active session.

In rare cases, you might be advised to run adflush to clear the Active Directory cache before performing an in-place upgrade. For example, if you are updating agents from version 4.x, or earlier, to 5.1.x, run adflush first to ensure a smooth upgrade. It is highly unusual for an upgrade to require you to leave and rejoin a managed Mac computer to the domain.

Administrators may choose to block OS version upgrades using group policy. For more information, please review KB-5765: How to block OS X updates via Group Policy.

For additional information not covered in this guide or troubleshooting assistance, please review Centrify Online Help or the Customer Support Portal at

Still have questions? Click here to log a technical support case, or collaborate with your peers in Centrify's Online Community.