forked from cloudfoundry/docs-bosh
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathbosh-cli.html.md.erb
59 lines (38 loc) · 2.26 KB
/
bosh-cli.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
---
title: BOSH Command Line Interface
---
BOSH Command Line Interface (CLI) is used to interact with the Director. The CLI is written in Ruby and is distributed via `bosh_cli` gem.
<pre class="terminal">
$ gem install bosh_cli --no-ri --no-rdoc
</pre>
<p class="note">Note: BOSH CLI requires Ruby 2+</p>
If gem installation does not succeed, make sure pre-requisites for your OS are met.
### Prerequisites on Ubuntu Trusty
Make sure following packages are installed:
<pre class="terminal">
$ sudo apt-get install build-essential ruby ruby-dev libxml2-dev libsqlite3-dev libxslt1-dev libpq-dev libmysqlclient-dev zlib1g-dev
</pre>
### Prerequisites on CentOS
Make sure following packages are installed:
<pre class="terminal">
$ sudo yum install gcc ruby ruby-devel mysql-devel postgresql-devel postgresql-libs sqlite-devel libxslt-devel libxml2-devel yajl-ruby
</pre>
### Prerequisites on Mac OS X
You may see an error like this: <pre>ERROR: While executing gem ... (Gem::FilePermissionError) ↵ You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.</pre>
Instead of using the system Ruby, install a separate Ruby for your own use, and switch to that one using a package like RVM, rbenv, or chruby.
You may see an error like this: <pre>The compiler failed to generate an executable file. (RuntimeError). You have to install development tools first.</pre>
Make sure you have installed Xcode and the command-line developer tools, and agreed to the license.
<pre class="terminal">
$ xcode-select --install
xcode-select: note: install requested for command line developer tools
</pre>
A window will pop up saying: <pre>The "xcode-select" command requires the command line developer tools. Would you like to install the tools now?</pre> Choose Install to continue. Choose Get Xcode to install Xcode and the command line developer tools from the App Store. If you have already installed Xcode from the App Store, you can choose Install and it will install the cli tools.
If you have successfully installed them, you will see this:
<pre class="terminal">
$ xcode-select --install
xcode-select: error: command line tools are already installed, use "Software Update" to install updates
</pre>
To agree to the license:
<pre class="terminal">
$ sudo xcodebuild -license
</pre>