Shine - Lustre file system administration utility
ClusterShell: 1.5.1+ (http://github.com/cea-hpc/clustershell/)
Supports Lustre (http://lustre.org/) versions: 1.8, 2.1, 2.4 and above
When possible, please use the RPM distribution for an easy install. You can get it from http://github.com/cea-hpc/shine/releases/latest/.
If you want to do it from source, type:
# python setup.py install
On RHEL-6 like systems, you may want to use the provided init script:
# cp /var/share/shine/shine.init.redhat /etc/rc.d/init.d/shine
Make sure Shine is installed on all nodes.
Edit the file
/etc/shine/shine.conf and copy it on all nodes.
To create myfs Lustre file system, copy the provided file system model file:
# cd /etc/shine/models # cp example.lmf myfs.lmf
myfs.lmf to match your needs. This file describes the file system
to be installed.
Install the file system with:
# shine install -m /etc/shine/models/myfs.lmf
Then format the file system with:
# shine format -f myfs
Start servers with:
# shine start -f myfs
Mount clients with:
# shine mount -f myfs
If you modify Shine source code, do not forget to test it with the test suite
tests/ directory of the source code.
python-nose is the recommended way to run the testsuite. However
provided with Python 2.7 and above should also works.
$ export PYTHONPATH=$PWD/lib $ cd tests $ nosetests -v <TESTFILE.PY> $ nosetests -v --all-modules
Some tests expect being able to ssh into the current hostname without password,
ssh $HOSTNAME echo ok works.
Some tests needs to launch real Lustre commands and so needs to have root permissions. These tests will be skipped if you do not have these permissions.
# nosetests -v --all-modules