Installing and Uninstalling the Cloudify CLI

Get the latest docs.

You are looking at documentation for an older release. Not what you want? Use the version selector on the top banner or click here.

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.

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:

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:

Download the OSX installation package.
Install the package with Installer or from the CLI:

Installer

Double click the file to open the Installer. If you need ‘Open With’, open the Installer app located in your Utilities folder.

CLI
```
    $ sudo installer -pkg <pkg.pkg> -target /
    
```
Where </path/to/pkg.pkg> is the path to the installation file.

Installing on Windows

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

Python 2.7.x
Pip
Virtualenv
Cloudify

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.

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 Managers 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

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

To uninstall the CLI from the host, run:

     $ cd /usr/local/opt/cfy
     $ pkgutil --only-files --files test.gigaspaces.pkg.cloudify | tr '\n' '\0' | xargs -n 1 -0 sudo rm -f
     $ pkgutil --only-dirs --files test.gigaspaces.pkg.cloudify | tail -r | tr '\n' '\0' | xargs -n 1 -0 sudo rmdir
     $ pkgutil --forget test.gigaspaces.pkg.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.