Skip to content

cloudify-cosmo/cloudify-manager-install

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cloudify Manager Install

Circle CI Code Health

A new, simpler, way to install a Cloudify manager. Runs in half the time, with a fraction of the frustration. 1000% satisfaction guaranteed.

Usage

Installation

In the local install, the only thing the user needs, is a single RPM.

The RPM is now live on S3 (community version can be found here, the premium can be found here). You can download and install it, following the instructions below.

For those who wish to manually create their own RPM (for development purposes) see below steps 1-6.

Creating the RPM

  1. SSH into a clean VM (or a bare metal server, of course).
  2. Download the create_rpm script to the machine with:

curl -L -O https://raw.githubusercontent.com/cloudify-cosmo/cloudify-manager-install/master/packaging/create_rpm

  1. Give it executable permissions:

chmod +x create_rpm

  1. Execute the script:

Note: For this to work you will either need an ssh key that can access cloudify-premium (premium) or cloudify-versions (community), or you will need to export GITHUB_USERNAME and GITHUB_TOKEN env vars.

./create_rpm

To build community, execute with: ./create_rpm --edition community

  1. This will result in an rpm created in /tmp/cloudify-manager-install-premium-1.0-1.x86_64.rpm or /tmp/cloudify-manager-install-community-1.0.1.x86_64.rpm.

Note that steps 1-6 may be performed on a machine other than the one intended to serve as a Cloudify manager. It will be then up to the user to ensure the rpm is then copied to the other machine.

Installing Cloudify Manager

  1. yum install the rpm:

sudo yum install -y /tmp/cloudify-manager-install-premium-1.0-1.x86_64.rpm or sudo yum install -y /tmp/cloudify-manager-install-community-1.0-1.x86_64.rpm

  1. This step extracts necessary files on the system and gives permissions to the /etc/cloudify/config.yaml file. One of the files extracted is the cfy_manager executable which will be used to actually install the manager.
  2. Only the private and public IPs are necessary to install the manager, and those can be provided directly to the executable like this:

cfy_manager install --private-ip <PRIVATE-IP> --public-ip <PUBLIC-IP>

If more configurations are necessary, you may edit the config file in: /etc/cloudify/config.yaml.

  1. After the command has finished, you should have a working manager, with cfy installed for both the current user and root.

Configuration

If you wish to change some configuration after install, just edit config.yaml again and run cfy_manager configure. It takes about a minute.

Teardown

At any point, you can run cfy_manager remove, which will remove everything Cloudify related from the machine, except the installation code, that will remain in /etc/cloudify/config.yaml, so that you will have the ability to run cfy_manager install again.

Goodies

  • cfy_manager install and cfy_manager configure can be run as many times as you like. The commands are completely idempotent.
  • Want to reconfigure the manager, but don't want to drop the DB? Set "postgres": {"create_db": false}" in the config file.
  • Working in offline mode? No problem. cfy_manager install can be used as is, assuming the RPM was somehow delivered to the machine.
  • Detailed debug logs of the installation process are available in /var/log/cloudify/manager/cfy_manager.log