Command Line Interface (CLI) Installation

Installing the Cloudify CLI

To remotely connect to Cloudify Manager, you can install the Cloudify Command Line Interface (CLI) on a separate host. The Cloudify CLI includes all of the commands necessary to run any actions on Cloudify Manager.

The CLI is deployed by default on the Cloudify Manager. When connected to the manager via SSH, CLI commands can be executed locally without deploying the CLI.

After you download the Cloudify CLI installation package, the installation process does not require an active internet connection.

Installing on Linux

To install Cloudify CLI on Linux, you could use either a single file binary, a RPM package and a DEB package.

Single file binary installation

To install a single file binary on your machine, run the following command:

$ curl -sfL https://cloudify.co/get-cli | sh -

This will execute a script which will:

determine if your machine meets the requirements:
- has a x86_64 architecture,
- has curl, sudo and one of the three: openssl, shasum or sha256sum binaries available,
download the binary Cloudify CLI, verify its integrity and install it as /usr/local/bin/cfy,
create CLI auxiliary directories for the current user.

Installation from the packages

Download the installation package for your package management system, either RPM or DEB.
To install from the CLI on the host, run the command for your operating system.

Centos/RHEL
```
    $ sudo rpm -i <pkg.rpm>
    
```
Where <pkg.rpm> is the path to the installation file.

Debian/Ubuntu
```
    $ sudo dpkg -i <pkg.deb>
    
```
Where <pkg.deb> is the path to the installation file.

Installing on Mac OSX

To install Cloudify CLI on Mac OSX, you could use either a single file binary, or Python’s pip.

Single file binary installation

To install a single file binary on your machine, run the following command.

$ curl -sfL https://cloudify.co/get-cli | sh -

This will execute the script which will:

determine if your machine meets the requirements:
- has either x86_64 or arm64 architecture,
- has curl, sudo and one of the three: openssl, shasum or sha256sum binaries available,
download the binary Cloudify CLI, verify its integrity and install it as /usr/local/bin/cfy,
create CLI auxiliary directories for the current user.

Installation from PyPI (Python Package Index)

Install the package using python package manager:

    $ sudo pip install cloudify=<Cloudify version, for example: 6.4.0>

Installing on Windows

The Windows installer is a single executable that installs these components:

Python 2.7.x
Pip
Virtualenv
Cloudify CLI

If the Python installation shows an error, install make sure that Microsoft Visual C++ 2008 Redistributable is installed.

The Python setup wizard prompts you to choose to install pip. If you choose not to install pip, it is installed anyway because it is required by the Cloudify environment.

Windows security tools may identify the Cloudify CLI as an unrecognized app. If this happens, select the “more info” option and then click “Run anyway”.

To install Cloudify CLI on Windows:

Download the EXE installation package for Windows.
Run the installer and respond to the prompts in the installation wizard.

Uninstalling the Cloudify CLI

When you uninstall the Cloudify CLI, you only remove the CLI from the local host. This process does not change the configurations on the Cloudify Manager that you used the CLI to connect to.

The Python, pip or Virtualenv packages are not removed when you remove the Cloudify CLI package.

Uninstalling from Linux

Single file binary installation

To uninstall the CLI which was installed as a single file binary, just remove it with

$ sudo rm /usr/local/bin/cfy

Installation from the packages

To uninstall the CLI from the host, run the command for your operating system.

Centos/RHEL

$ sudo rpm -e cloudify

Debian/Ubuntu

$ sudo dpkg -r cloudify

Uninstalling from Mac

Single file binary installation

To uninstall the CLI which was installed as a single file binary, just remove it with

$ sudo rm /usr/local/bin/cfy

Installation from PyPI (Python Package Index)

To uninstall the CLI from the host, run:

$ pip uninstall cloudify

Uninstalling from Windows

To uninstall the CLI from the host:

Go to the Control Panel and open Apps.
Select Cloudify CLI and click Uninstall.