This guide will walk you through the installation of the open source implementation of the Citrix XenCenter called OpenXenManager. The application is used as a graphical way to manage a Xen Hypervisor.

This tutorial was successfully tested on macOS Sierra (10.12.2).

Installation

  1. First you need to install the Homebrew package manager. You can do this by executing the following in a terminal.
    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Update Homebrew like this:
    brew update && brew upgrade
    
  3. Install XQuartz:
    brew cask install xquartz 
    
  4. Install the other dependencies:
    brew install python gtk pygtk FLTK git
    
  5. Install TigerVNC:
    brew install https://gist.githubusercontent.com/steakknife/064302dc55e76231d612/raw/tiger-vnc.rb
    
  6. Install configobj:
    pip install configobj
    
  7. Clone the latest OpenXenManager source:
    mkdir ~/tmp
    cd ~/tmp
    git clone https://github.com/OpenXenManager/openxenmanager
    cd openxenmanager
    
  8. Build OXM:
    python setup.py build 
    
  9. Install OXM:
    python setup.py install
    
  10. Start OXM for the first time. After startup close it:
    /usr/local/bin/openxenmanager
    
  11. Modify the config file:
    vi ~/.config/openxenmanager/oxc.conf
    
  12. Find the vnc_viewer property and replace it’s value with: /usr/local/bin/vncviewer

OpenXenManager is now installed and ready for use. You can even use the remote console.

Known Bugs

  • The remote console closes with unknown message when the screen resolution changes (eg. when booting or installing Linux)
  • Some features of OpenXenManager are not yet implemented.
  • Exiting OXM takes a long time or doesn’t work
  • Changing a VM’s RAM value in the Settings works but it isn’t updated in the UI