Chapter 5. Administrator CLI Operations

5.1. Overview

This topic provides information on the administrator CLI operations and their syntax. You must setup and login with the CLI before you can perform these operations.

The administrator CLI uses the oadm command, and is used for administrator operations. This differs from the developer CLI, which uses the oc command, and is used for basic, project-level operations.

5.2. Common Operations

The administrator CLI allows interaction with the various objects that are managed by OpenShift Enterprise. Many common oadm operations are invoked using the following syntax:

$ oadm <action> <option>

This specifies:

  • An <action> to perform, such as new-project or router.
  • An available <option> to perform the action on as well as a value for the option. Options include --output or --credentials.

5.3. Basic CLI Operations

5.3.1. new-project

Creates a new project:

$ oadm new-project <project_name>

5.3.2. policy

Manages authorization policies:

$ oadm policy

5.3.3. groups

Manages groups:

$ oadm groups

5.4. Install CLI Operations

5.4.1. router

Installs a router:

$ oadm router <router_name>

5.4.2. ipfailover

Installs an IP failover group for a set of nodes:

$ oadm ipfailover <ipfailover_config>

5.4.3. registry

Installs an integrated Docker registry:

$ oadm registry

5.5. Maintenance CLI Operations

5.5.1. build-chain

Outputs the inputs and dependencies of any builds:

$ oadm build-chain <image-stream>[:<tag>]

5.5.2. manage-node

Manages nodes. For example, list or evacuate pods, or mark them ready:

$ oadm manage-node

5.5.3. prune

Removes older versions of resources from the server:

$ oadm prune

5.6. Settings CLI Operations

5.6.1. config

Changes kubelet configuration files:

$ oadm config <subcommand>

5.6.2. create-kubeconfig

Creates a basic .kubeconfig file from client certificates:

$ oadm create-kubeconfig

5.6.3. create-api-client-config

Creates a configuration file for connecting to the server as a user:

$ oadm create-api-client-config

5.7. Advanced CLI Operations

5.7.1. create-bootstrap-project-template

Creates a bootstrap project template:

$ oadm create-bootstrap-project-template

5.7.2. create-bootstrap-policy-file

Creates the default bootstrap policy:

$ oadm create-bootstrap-policy-file

5.7.3. create-login-template

Creates a login template:

$ oadm create-login-template

5.7.4. overwrite-policy

Resets the policy to the default values:

$ oadm overwrite-policy

5.7.5. create-node-config

Creates a configuration bundle for a node:

$ oadm create-node-config

5.7.6. ca

Manages certificates and keys:

$ oadm ca

5.8. Other CLI Operations

5.8.1. version

Displays the version of the indicated object:

$ oadm version

5.8.2. help

Displays help about any command:

$ oadm help <command>