https://github.com/cloudify-cosmo/cloudify-manager-install
A new, simpler, way to install a Cloudify manager
https://github.com/cloudify-cosmo/cloudify-manager-install
Last synced: 4 months ago
JSON representation
A new, simpler, way to install a Cloudify manager
- Host: GitHub
- URL: https://github.com/cloudify-cosmo/cloudify-manager-install
- Owner: cloudify-cosmo
- Created: 2017-11-07T11:36:54.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-02-13T10:15:03.000Z (over 1 year ago)
- Last Synced: 2025-02-13T11:26:56.963Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 3.38 MB
- Stars: 14
- Watchers: 25
- Forks: 13
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Cloudify Manager Install
[](https://circleci.com/gh/cloudify-cosmo/cloudify-manager-install/tree/master)
[](https://landscape.io/github/cloudify-cosmo/cloudify-manager-install/master)
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](https://github.com/cloudify-cosmo/cloudify-versions/blob/master/packages-urls/manager-install-rpm.yaml), the
premium can be found [here](https://github.com/cloudify-cosmo/cloudify-premium/blob/master/packages-urls/manager-install-rpm.yaml)).
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`](packaging/create_rpm) script to the machine
with:
`curl -L -O https://raw.githubusercontent.com/cloudify-cosmo/cloudify-manager-install/master/packaging/create_rpm`
3. Give it executable permissions:
`chmod +x create_rpm`
4. 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`
5. 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
6. `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`
7. 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.
8. 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 --public-ip `
If more configurations are necessary, you may edit the config file in:
`/etc/cloudify/config.yaml`.
9. 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`