Installing xadm - PixarAnimationStudios/xolo GitHub Wiki

Installing xadm

These instructions are pretty barebones to start with. They'll be expanded as more folks install and use Xolo.

Everyone who will be managing titles and versions with in Xolo needs to install xadm on their macs.

Install ruby 2.7 or higher

  • While xadm will work with the OS-supplied version of ruby, it isn't recommended.
    • Apple could remove it at any time.
  • There are many ways to install ruby, the most common being homebrew.
  • xadm has been tested up to ruby 3.3. The current version 3.4 should work fine. Please let us know if not!

Install the xolo-admin gem

  • gem install xolo-admin
    • Add cli-options as needed for your ruby installation (see gem help install)
    • This should install all dependencies
    • By default, the xadm executable will probably go into /usr/local/bin

Configure xadm

  • Run xadm help config to see all possible configuration options and full descriptions/documentation
  • Run xadm config to see the interactive configuration menu.
  • Required Values:
    • Xolo Server Hostname, e.g. xolo.myschool.edu
    • Username. The user must be a member of the Jamf Pro account-group specified in the servers "admin_jamf_group"
      • The user need not have any permissions to access the Jamf Pro server directely.
    • Password. The user's password for authentication to Jamf Pro.

Use xadm

  • xadm help or xadm help <command>
⚠️ **GitHub.com Fallback** ⚠️