mirror of
				https://github.com/xcat2/xcat-core.git
				synced 2025-10-26 08:55:24 +00:00 
			
		
		
		
	git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@12302 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
		
			
				
	
	
		
			117 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			117 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| =head1 NAME
 | |
| 
 | |
| B<nodech> - Changes nodes' attributes in the xCAT cluster database.
 | |
| 
 | |
| 
 | |
| =head1 SYNOPSIS
 | |
| 
 | |
| B<nodech> I<noderange> I<table.column=value> [I<...>]
 | |
| 
 | |
| B<nodech> {B<-d> | B<--delete>} I<noderange> I<table> [I<...>]
 | |
| 
 | |
| B<nodech> {B<-v> | B<--version>}
 | |
| 
 | |
| B<nodech> [B<-?> | B<-h> | B<--help>]
 | |
| 
 | |
| 
 | |
| =head1 DESCRIPTION
 | |
| 
 | |
| The nodech command changes the specified attributes for the given nodes.  Normally, the given
 | |
| value will completely replace the current attribute value.  But if ",=" is used instead of "=",
 | |
| the specified value will be prepended to the attribute's comma separated list, if it is not already
 | |
| there.  If "^=" is used, the specified value will be removed from the attribute's comma separated list,
 | |
| if it is there.  You can also use "^=" and ",=" in the same command to essentially replace one item
 | |
| in the list with another.  (See the Examples section.)
 | |
| 
 | |
| Additionally, as in nodels, boolean expressions can be used to further limit the scope of nodech from 
 | |
| the given noderange.  The operators supported are the same as nodels (=~, !~, ==, and !=).
 | |
| 
 | |
| With these operators in mind, the unambiguous assignment operator is '=@'.  If you need, for example, to set
 | |
| the nodelist.comments to =foo, you would have to do I<nodech n1 nodelist.comments=@=foo>.
 | |
| 
 | |
| See the B<xcatdb> man page for an overview of each table.
 | |
| 
 | |
| The nodech command also supports some short cut names as aliases to common attributes.  See the
 | |
| B<nodels> man page for details.
 | |
| 
 | |
| 
 | |
| =head1 OPTIONS
 | |
| 
 | |
| =over 10
 | |
| 
 | |
| =item B<-d|--delete>
 | |
| 
 | |
| Delete the nodes' row in the specified tables.
 | |
| 
 | |
| =item B<-v|--version>
 | |
| 
 | |
| Command Version.
 | |
| 
 | |
| =item B<-?|-h|--help>
 | |
| 
 | |
| Display usage message.
 | |
| 
 | |
| =back
 | |
| 
 | |
| 
 | |
| =head1 RETURN VALUE
 | |
| 
 | |
| =over 3
 | |
| 
 | |
| =item 0
 | |
| 
 | |
| The command completed successfully.
 | |
| 
 | |
| =item 1
 | |
| 
 | |
| An error has occurred.
 | |
| 
 | |
| =back
 | |
| 
 | |
| 
 | |
| =head1 EXAMPLES
 | |
| 
 | |
| =over 2
 | |
| 
 | |
| =item *
 | |
| 
 | |
| To update nodes in noderange  node1-node4 to be in only group all:
 | |
| 
 | |
| B<nodech> I<node1-node4 groups=all>
 | |
| 
 | |
| =item *
 | |
| 
 | |
| To put all nodes with nodepos.rack value of 2 into a group called rack2:
 | |
| 
 | |
| B<nodech> I<all> nodepos.rack==2 groups,=rack2
 | |
| 
 | |
| =item *
 | |
| 
 | |
| To add nodes in noderange  node1-node4 to the nodetype table with os=rhel5:
 | |
| 
 | |
| B<nodech> I<node1-node4 groups=all,rhel5 nodetype.os=rhel5>
 | |
| 
 | |
| =item *
 | |
| 
 | |
| To add node1-node4 to group1 in addition to the groups they are already in:
 | |
| 
 | |
| B<nodech> I<node1-node4 groups,=group1>
 | |
| 
 | |
| =item *
 | |
| 
 | |
| To put node1-node4 in group2, instead of group1:
 | |
| 
 | |
| B<nodech> I<node1-node4 groups^=group1 groups,=group2>
 | |
| 
 | |
| =back
 | |
| 
 | |
| 
 | |
| =head1 FILES
 | |
| 
 | |
| /opt/xcat/bin/nodech
 | |
| 
 | |
| 
 | |
| =head1 SEE ALSO
 | |
| 
 | |
| L<nodels(1)|nodels.1>, L<nodeadd(8)|nodeadd.8>, L<noderange(3)|noderange.3>
 |