forked from cloudfoundry/docs-bosh
-
Notifications
You must be signed in to change notification settings - Fork 0
/
bosh-cli.html.md.erb
69 lines (45 loc) · 2.44 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
60
61
62
63
64
65
66
67
68
69
---
title: BOSH Command Line Interface
---
BOSH Command Line Interface (CLI) is used to interact with the Director and to bootstrap new BOSH environments. The CLI is written in Ruby and is provided by the two gems:
* `bosh_cli` contains main operator commands [<img src="https://badge.fury.io/rb/bosh_cli.png" />]
* `bosh_cli_plugin_micro` contains bootstrapping commands [<img src="https://badge.fury.io/rb/bosh_cli_plugin_micro.png" />]
To install both of these gems:
<pre class="terminal">
$ gem install bosh_cli bosh_cli_plugin_micro --no-ri --no-rdoc
</pre>
<p class="note">Note: BOSH CLI requires Ruby 2+</p>
Use the following command to consult the BOSH CLI help and to verify that CLI can run:
<pre class="terminal">
$ bosh help
</pre>
---
## <a id="troubleshooting"></a> Installation Troubleshooting
If gems 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>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>