-
Notifications
You must be signed in to change notification settings - Fork 12
Setup install d3 on your mac
Be sure to follow the steps in "Preparing the servers" and Policies, Scripts, and Extension Attributes first!
To continue setup, you need to install d3 onto your own machine, and start using d3admin.
d3 and d3admin are command-line tools. You'll be doing all this in a terminal.
A .pkg installer is available for d3. Get the latest version from the Download link on the d3 homepage
If you use it, it will install d3, and all it's dependencies. It installs them in the OS-default location for system-wide Ruby Gems: /Library/Ruby/Gems/2.0.0/ If that location works for your site, you'll be able to use that .pkg to install d3 on your managed computers.
If your site uses a non-standard location for deployed Ruby gems, you should use the steps below. You'll have to then manually move some items from the gem install folder into place. You'll also have to manually
The command sudo gem install depot3 -n/usr/local/bin should install the d3 libraries, the ruby-jss libraries and all other dependencies.
IMPORTANT: that -n/usr/local/bin is required for ElCapitan and higher, and wise for Yosemite and lower.
If you store rubygems in non-standard places, you might want to use the --install-dir option or set the GEM_HOME environment variable. By default, OS X (10.9 and up, which d3 requires) it should end up in
/Library/Ruby/Gems/2.0.0/(gems/doc/bin..)
Once installed you should be able to access the executables in the bin directory of your system-wide gem home (/Library/Ruby/Gems/2.0.0/bin if you don't use something else)
You should leave those there, but symlink to them from elsewhere, like /usr/local/bin or /usr/local/sbin.
Test out that it's installed by typing d3 --version
d3 keeps its working data in a support folder: /Library/Application Support/d3/.
To set it up, grab it from inside the data folder of the newly installed depot3 gem (e.g. /Library/Ruby/Gems/2.0.0/gems/depot3-<version>/data/d3/). Move or copy that d3 folder into /Library/Application Support/ and make sure it's not world or group writable.