ParaStation ClusterTools Administrator's Guide

Release 1.0.5-4

Juli 2011

Reproduction in any manner whatsoever without the written permission of ParTec Cluster Competence Center GmbH is strictly forbidden.

All rights reserved. ParTec and ParaStation are registered trademarks of ParTec Cluster Competence Center GmbH. The ParTec logo and the ParaStation logo are trademarks of ParTec Cluster Competence Center GmbH. Linux is a registered trademark of Linus Torvalds. All other marks and names mentioned herein may be trademarks or registered trademarks of their respective owners.

This document provides detailed information about the ParaStation ClusterTools. Installation and configuration of the ParaStation ClusterTools as well as usage of the ParaStation ClusterTools commands are explained in-depth.

Though it may seem hard to believe, this manual might contain errors. We welcome any reports on errors or problems that are found. We also would appreciate suggestions on improving this book. Please direct all comments and problems to .

The most up-to-date version of this document is available at


Share your knowledge with others. It's a way to achieve immortality.

 --Dalai Lama

Table of Contents

1. Preface
About this book
This book's audience
ParaStation ClusterTools overview
2. Setting up the master node
Recommended disk layout
Required services and configuration hints
Preparing the ParaStation ClusterTools
Using the ParaStation ClusterTools setup tool
cluster-install.master install_rpms: Installing special packages
cluster-install.master setup_dns: Setting up DNS server
cluster-install.master config_ps: Configuring ParaStation
cluster-install.master setup_nfs_nis: Configuring NFS, NIS and NTP
cluster-install.master setup_syslog: Setting up syslog
cluster-install.master setup_batch: Setting up batch system
cluster-install.master setup_golden_client: Setting up Golden Client
cluster-install.master setup_SIS: Setting up SIS
cluster-install.master setup_ipmi: Setting up IPMI access
cluster-install.master setup_misc: Setting up miscellaneous configurations
3. Setting up and maintaining compute nodes
Compute node images
Adding compute nodes
Replacing compute nodes
Updating compute nodes
Extending the cluster
Managing compute nodes using IPMI
Turning nodes on/off
Using remote console
More IPMI functions
I. Reference Pages
psnodes-getimage — ParaStation Cluster Tools: retrieve or update an image from a golden client
psnodes-update — ParaStation Cluster Tools: update nodes according to their corresponding images.
psnodes-replace — ParaStation Cluster Tools: determine MAC address, update DHCP configuration and reinstall a node.
psnodes-reinstall — ParaStation Cluster Tools: re-install a single known node.
psnodes-addnew — ParaStation Cluster Tools: Add new nodes to existing cluster
psnodes-admin — ParaStation Cluster Tools: manipulate node database.
pspowercycle — ParaStation Cluster Tools: turn on or off a node.
pssyslog — ParaStation Cluster Tools: monitor one or more logfile(s) in parallel
pslshw — ParaStation Cluster Tools: list basic hardware components
pschglog — ParaStation Cluster Tools: add and list change log entries.
psipmi — ParaStation Cluster Tools: get/set IPMI related information.
psmaintenance — ParaStation Cluster Tools: control NextMaintenance time and NextAction flag.
psnodes-specialboot — ParaStation Cluster Tools: PXE boot single node with special boot file
pstiblink — ParaStation Cluster Tools: Test IB link
pssetbios — ParaStation Cluster Tools: set or get BIOS settings
psconsole — ParaStation Cluster Tools: console connection to specified node
pschecknodes — ParaStation Cluster Tools: check offline nodes and set online.
pscluster.conf — ParaStation Cluster Tools: global configuration file