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.0
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.0

# ansible 2.9.0 
sudo pip install ansible==2.9.0

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.0-pippackages.zip
cd ansible-2.9.0-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

Install all this required packages on all your others servers.

Execute the following packages installation:

sudo yum install \
    unzip \
    jq \
    sshpass

Install Python 3.6.8

Install Python 3.6.8 on all nodes where Shiva or PySpark will be installed.

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

Specific features

Ceph specific requirements

Ceph is not supported on Darwin OS.