From 9d9744341052a2d84bda57c3d3dc2252d707d5dd Mon Sep 17 00:00:00 2001
From: linggao <linggao@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Mon, 13 Oct 2008 21:42:21 +0000
Subject: [PATCH] man page for updatenode

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@2341 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client/pods/man1/updatenode.1.pod | 83 ++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 xCAT-client/pods/man1/updatenode.1.pod

diff --git a/xCAT-client/pods/man1/updatenode.1.pod b/xCAT-client/pods/man1/updatenode.1.pod
new file mode 100644
index 000000000..24e1fab59
--- /dev/null
+++ b/xCAT-client/pods/man1/updatenode.1.pod
@@ -0,0 +1,83 @@
+=head1 NAME
+
+B<updatenode> - Reruns postsctipts or runs additional scripts on the nodes. 
+
+
+
+=head1 SYNOPSIS
+
+I<updatenode [-h| --help]>
+
+I<updatenode [-v| --version]>
+
+I<updatenode I<noderange> [I<script1>[,I<script2>...]]>
+
+
+=head1 DESCRIPTION
+
+This command is used for the following:
+1 install additional software for stateful nodes.
+2 run postscripts defined in the postscripts table for both stateful and stateless nodes.  
+3 run any script for both stateful and stateless nodes. 
+
+=head1 Parameters
+
+I<noderange> is a list of nodes and node groups.
+
+I<script1,script2...> a list of script names. The scripts must be copied under /install/postsctipts directory. They can be from the I<postsctipts> table or not. 
+
+=head1 OPTIONS
+
+B<-h | --help>         Display usage message.
+
+B<-v | --version >      Command Version.
+
+=head1 RETURN VALUE
+
+0 The command completed successfully.
+
+1 An error has occurred.
+
+=head1 EXAMPLES
+
+1. To install additional software for Linux stateful nodes, first copy the extra rpms you are going to add on to
+
+ /install/post/otherpkgs/<os>/<arch>/* 
+
+directory where <os> and <arch> are defined in the I<nodetype> table. 
+
+Second, add rpm names (without version number) into
+
+ /install/custom/install/<ostype>/profile.otherpkgs.pkglist 
+
+where <profile> is defined in the I<nodetype> table. <ostype> is the operating system name without the version number. The following os types are recognized by xCAT.
+
+  centos 
+  fedora 
+  rh
+  sles 
+  windows
+
+Third, type:
+
+   updatenode <noderange> otherpkgs
+ 
+2. To re-run all the postscripts for the nodes, type
+
+   updatenode <noderange> 
+
+3. To re-run the syslog postscripts for the nodes, type
+
+   updatenode <noderange> syslog
+
+4. To run a list of scripts, make sure the scripts are copied to /install/postscripts directory, then type
+   updatenode <noderange> script1,script2
+
+Note: script1,script2 may or may not be defined in the postscripts table. However if  you want script1 and script2 get invoked next time the nodes are deployed, add them into the postscripts table.
+
+
+=head1 FILES
+
+/opt/xcat/bin/updatenode
+
+