ClusterShellOnMacOSX

Install and use ClusterShell on Mac OS X

Since version 1.4.1, it is possible to fully use ClusterShell on Mac OS X. Instructions found in this page have been tested on Mac OS X 10.5 "Leopard".

Install

Get and untar the source tarball. Installation is made easy thanks to setuptools:

$ sudo python setup.py install

Install config files

This part is not automated on Mac OS X. You could live without config files, but for instance, you wouldn't be able to use NodeGroups. Please follow these easy steps:

$ sudo mkdir /etc/clustershell

$ sudo cp -v conf/* /etc/clustershell/

You might need to decrease fd_max's value in /etc/clustershell/clush.conf, because on Mac OS X the number of open files is limited to 10240 (OPEN_MAX). fd_max: 4096, for example, should work fine with most clusters.

$ sudo vi /etc/clustershell/clush.conf

Full installation log example

macary:~ admin$ tar -xzf clustershell-1.4.1.tar.gz
macary:~ admin$ cd clustershell-1.4.1
macary:clustershell-1.4.1 admin$ sudo python setup.py install
running install
running bdist_egg
running egg_info
creating lib/ClusterShell.egg-info
writing lib/ClusterShell.egg-info/PKG-INFO
writing top-level names to lib/ClusterShell.egg-info/top_level.txt
writing dependency_links to lib/ClusterShell.egg-info/dependency_links.txt
writing manifest file 'lib/ClusterShell.egg-info/SOURCES.txt'
reading manifest file 'lib/ClusterShell.egg-info/SOURCES.txt'
writing manifest file 'lib/ClusterShell.egg-info/SOURCES.txt'
installing library code to build/bdist.macosx-10.5-i386/egg
running install_lib
running build_py
creating build
creating build/lib
creating build/lib/ClusterShell
copying lib/ClusterShell/__init__.py -> build/lib/ClusterShell
...
byte-compiling build/bdist.macosx-10.5-i386/egg/ClusterShell/Worker/Worker.py to Worker.pyc
writing byte-compilation script '/tmp/tmpnfzhhn.py'
/System/Library/Frameworks/Python.framework/Versions/2.5/Resources/Python.app/Contents/MacOS/Python -O /tmp/tmpnfzhhn.py
removing /tmp/tmpnfzhhn.py
creating build/bdist.macosx-10.5-i386/egg/EGG-INFO
installing scripts to build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts
running install_scripts
running build_scripts
creating build/scripts-2.5
copying and adjusting scripts/clubak -> build/scripts-2.5
copying and adjusting scripts/clush -> build/scripts-2.5
copying and adjusting scripts/nodeset -> build/scripts-2.5
changing mode of build/scripts-2.5/clubak from 644 to 755
changing mode of build/scripts-2.5/clush from 644 to 755
changing mode of build/scripts-2.5/nodeset from 644 to 755
creating build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts
copying build/scripts-2.5/clubak -> build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts
copying build/scripts-2.5/clush -> build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts
copying build/scripts-2.5/nodeset -> build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts
changing mode of build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts/clubak to 755
changing mode of build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts/clush to 755
changing mode of build/bdist.macosx-10.5-i386/egg/EGG-INFO/scripts/nodeset to 755
copying lib/ClusterShell.egg-info/PKG-INFO -> build/bdist.macosx-10.5-i386/egg/EGG-INFO
copying lib/ClusterShell.egg-info/SOURCES.txt -> build/bdist.macosx-10.5-i386/egg/EGG-INFO
copying lib/ClusterShell.egg-info/dependency_links.txt -> build/bdist.macosx-10.5-i386/egg/EGG-INFO
copying lib/ClusterShell.egg-info/top_level.txt -> build/bdist.macosx-10.5-i386/egg/EGG-INFO
zip_safe flag not set; analyzing archive contents...
creating dist
creating 'dist/ClusterShell-1.4.1-py2.5.egg' and adding 'build/bdist.macosx-10.5-i386/egg' to it
removing 'build/bdist.macosx-10.5-i386/egg' (and everything under it)
Processing ClusterShell-1.4.1-py2.5.egg
Copying ClusterShell-1.4.1-py2.5.egg to /Library/Python/2.5/site-packages
Adding ClusterShell 1.4.1 to easy-install.pth file
Installing clush script to /usr/local/bin
Installing nodeset script to /usr/local/bin
Installing clubak script to /usr/local/bin

Installed /Library/Python/2.5/site-packages/ClusterShell-1.4.1-py2.5.egg
Processing dependencies for ClusterShell==1.4.1
Finished processing dependencies for ClusterShell==1.4.1

macary:clustershell-1.4.1 admin$ sudo mkdir /etc/clustershell
macary:clustershell-1.4.1 admin$ sudo cp -v conf/* /etc/clustershell/
conf/clush.conf -> /etc/clustershell/clush.conf
conf/groups -> /etc/clustershell/groups
conf/groups.conf -> /etc/clustershell/groups.conf


macary:clustershell-1.4.1 admin$ sudo vi /etc/clustershell/clush.conf (change fd_max setting)
macary:clustershell-1.4.1 admin$ clush --version
clush 1.4.1

macary:clustershell-1.4.1 admin$ clush -bw localhost uname -prs 
---------------
localhost
---------------
Darwin 9.8.0 i386