Command line interfaces for IBM® Cloud Private Cloud Foundry

To use IBM® Cloud Private Cloud Foundry, you might need to install some command line interfaces (CLIs).

BOSH: Use this CLI to manage the BOSH Director, which manages all the deployed virtual machines.
Cloud Foundry (Cloud Foundry CLI): Use this CLI to run core Cloud Foundry commands.

BOSH

To install the BOSH CLI, see BOSH Command Line Interface External link icon

For more information about the BOSH CLI, see BOSH CLI Community Documentation External link icon

Target a BOSH Director. You must be able to reach the director_ip IP address through the connected networks.
```
bosh alias-env IBMCloudPrivate -e https://<director_ip>:25555
```
Authenticate the BOSH CLI with a BOSH Director. In the following commands, the user name is admin. The password is the credentials.boshdirector.bosh.password parameter value in the credentials.yml file in the ./CloudFoundry folder of your installation configuration directory.
```
export BOSH_ENVIRONMENT=IBMCloudPrivate
bosh login
```
```
bosh logout
```
List BOSH deployments that are currently managed by the connected Director:
```
bosh deployments
```
List the virtual machines that are associated with a deployment:
```
bosh -d DEPLOYMENT_NAME vms [--details | --vitals]
```
Target a BOSH deployment with a single command:
```
bosh -d DEPLOYMENT BOSH_COMMAND
```
Persistently target a BOSH deployment manifest file:
```
export BOSH_DEPLOYMENT=DEPLOYMENT_NAME
```

Export a deployment's manifest:

bosh -d DEPLOYMENT_NAME download manifest MANIFEST_FILE.yml

List recent BOSH tasks:
```
bosh tasks recent
```
A list of BOSH task ID numbers is displayed.
View BOSH task details:
```
bosh task ID_NUMBER
```
Note: You can obtain a list of task numbers by displaying the recent BOSH tasks.

To install the Cloud Foundry CLI, see Installing the cf CLI External link icon .

For more information about the Cloud Foundry CLI, see Cloud Foundry Command Line Interface (cf CLI) External link icon .

Target a Cloud Foundry platform:
```
cf api https://api.<YOUR_DOMAIN>
```
Authenticate the Cloud Foundry CLI with a Cloud Foundry platform:
```
cf login
```
```
cf logout
```
Display more commands:
```
cf -h
```
Special consideration: The set-org-role and set-space-role do not function correctly with the latest version of the Cloud Foundry CLI. To run these commands, use version 6.13 of the Cloud Foundry CLI.