Skip to content

Darwin setup

Macos works as deployer server except that it does not allow you to deploy a CEPH cluster.

Deployer node setup

Install packages

First install Xcode. Then install the following packages:

sudo easy_install pip
sudo pip install ansible==2.9.7
brew install core-utils

Install Python 3.6.8

sudo apt install python3 python3-pip

Python 3.6.8 from source

If you do not have Python 3.6.8 in the official repository,
you can install Python 3.6.8 from source following this guide

Install Ansible 2.9.7

# ansible 2.9.7 
sudo pip install ansible==2.9.7

If you encounter problem setting up this required version of Ansible from your available repositories, you will find an offline setup tool in the deployment package of Punchplatform:

unzip punchplatform-deployer-x.y.z.zip
cd deployment_dependencies
unzip ansible-2.9.7-pippackages.zip
cd ansible-2.9.7-pippackages
sudo ./install.sh

Environment setup

This section will update your PATH so as to have the punchplatform-deployer.sh available.

cd punchplatform-deployer-<version>
echo "export PATH=`pwd`/bin:$PATH" >> ~/.bashrc
echo "source _punchplatform-bash-completion.sh" >> ~/.bashrc
source .bashrc

Configuration setup

Next, create your platform configuration directory.
This directory will hold the description of your target platform with the punchplatform.properties and the punchplatform-deployment.settings files.

Create configuration directory:

cd ~
mkdir pp-deployment-conf
cd pp-deployment-conf
echo "export PUNCHPLATFORM_CONF_DIR=`pwd`" >> ~/.bash_profile

Create logs directory:

cd ~
mkdir pp-deployment-logs
cd pp-deployment-logs
echo "export PUNCHPLATFORM_LOG_DIR=`pwd`" >> ~/.bash_profile

Then update your environment

source ~/.bash_profile

Check it worked as expected. The result of the env command must look like:

env | grep PUNCH
PUNCHPLATFORM_LOG_DIR=/home/vagrant/pp-deployment-logs
PUNCHPLATFORM_CONF_DIR=/home/vagrant/pp-deployment-conf

echo $PATH
PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/home/vagrant/bin:/data/deployer/punchplatform-deployer-<version>/bin

Targeted nodes setup

Specific features

Ceph specific requirements

Ceph is not supported on Darwin OS.