CLI Installation

Warning

Lightbend Orchestration is no longer actively developed and will reach its End of Life on April 15, 2020.

We recommend Migrating to the Improved Kubernetes Deployment Experience.

Deployment of your application requires the usage of a CLI tool, rp, provided by reactive-cli. Typically, you’ll want to install this on the same machine that you use kubectl or dcos from. A bastion host is recommended for production usage, but for local development this can be done on your own machine.

Install the CLI

macOS

Releases for macOS are available using Homebrew. To set this up and install the CLI, use the command below.

brew install lightbend/tools/reactive-cli

To upgrade to a newer version of the CLI, use brew upgrade.

brew upgrade lightbend/tools/reactive-cli

To verify your installation:

rp version

If you don’t have jq you must also install that: brew install jq.

Debian & Ubuntu

Debian and Ubuntu .deb packages are available on Lightbend’s Debian Repository. To set this up and install the CLI, use the command below. Debian 8, Ubuntu 14.04, and later are supported

wget -qO - https://downloads.lightbend.com/rp/keys/bintray-debian | \
    sudo apt-key add - && \
    echo "deb https://dl.bintray.com/lightbend/deb $(lsb_release -cs) main" | \
    sudo tee /etc/apt/sources.list.d/lightbend.list && \
    sudo apt-get install apt-transport-https -y && \
    sudo apt-get update && \
    sudo apt-get install reactive-cli

To upgrade to a newer version of the CLI, you can use apt-get.

sudo apt-get update && sudo apt-get install reactive-cli

To verify your installation:

rp version

CentOS & RHEL

CentOS and RHEL .rpm packages are available on Lightbend’s Yum Repository. To set this up and install the CLI, use the command below. CentOS 6, RHEL 6, and later are supported.

wget -qO - https://bintray.com/lightbend/rpm/rpm | \
    sudo tee /etc/yum.repos.d/bintray-lightbend-rpm.repo && \
    sudo yum install reactive-cli

Similarly, use yum to update your installation.

sudo yum update reactive-cli

To verify your installation:

rp version

Linux (Other)

Linux (generic .tar.gz file) packages are available on Lightbend’s Bintray Repository. To install, download the latest version (Available under the Files tab for a given version), extract it, and ensure that rp is available on your PATH.

Windows

Windows packages are available on Lightbend’s Bintray Repository. To install, download the latest version (Available under the Files tab for a given version) and extract it.

Ensure that rp.exe is on your PATH. A quick way to do this from PowerShell is to cd where rp.exe is located and run this:

$env:Path += ";" + $pwd.Path
If (-not (Test-Path $Profile)) {New-Item $profile -itemtype file}
Write-Output ('$env:Path += ";" + ''' + $pwd.Path + "'") | Out-File $profile -Append

Removing the rp PowerShell Alias

Within PowerShell, you must invoke rp.exe since rp refers to an alias. If you prefer, you may remove that alias from the current and subsequent shells:

Remove-Item alias:\rp -Force
If (-not (Test-Path $Profile)) {New-Item $profile -itemtype file}
echo "Remove-Item alias:\rp -Force" | Out-File $profile -Append