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 require real block file to work. This needs to be configured in
[general] noformat_dev=/dev/sda # Real block device file, only used in read-only noformat_jdev=/dev/sda1
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