mirror of
				https://github.com/xcat2/xcat-core.git
				synced 2025-11-03 21:02:34 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			94 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			94 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
=head1 NAME
 | 
						|
 | 
						|
B<runsqlcmd> -Runs sql command files against the current xCAT database.  
 | 
						|
 | 
						|
=head1 SYNOPSIS
 | 
						|
 | 
						|
 | 
						|
B<runsqlcmd> 
 | 
						|
 | 
						|
B<runsqlcmd> [B<-h>|B<--help>]
 | 
						|
 | 
						|
B<runsqlcmd> [B<-v>|B<--version>]
 | 
						|
 | 
						|
B<runsqlcmd> [B<-d>|B<--dir> I<directory_path>] [B<-V>|B<--verbose>] 
 | 
						|
 | 
						|
B<runsqlcmd> [B<-f>|B<--files> I<list of files>] [B<-V>|B<--verbose>] 
 | 
						|
 | 
						|
B<runsqlcmd> [B<-V>|B<--verbose>] [I<sql statement>] 
 | 
						|
 | 
						|
 | 
						|
=head1 DESCRIPTION
 | 
						|
 | 
						|
The runsqlcmd routine,  runs the sql statements contained in the *.sql files as input to the command against the current running xCAT database. Only DB2,MySQL and PostgreSQL databases are supported.  SQLite is not supported.  
 | 
						|
If no directory or filelist is provided,  the default /opt/xcat/lib/perl/xCAT_schema directory is used.
 | 
						|
If the directory is input with the -d flag,  that directory will be used.
 | 
						|
If a comma separated list of files is input with the -f flag, those files will be used. 
 | 
						|
 | 
						|
=head1 OPTIONS
 | 
						|
 | 
						|
=over 6
 | 
						|
 | 
						|
=item B<-h|--help>
 | 
						|
 | 
						|
Displays the usage message.
 | 
						|
 | 
						|
=item B<-v|--version>
 | 
						|
 | 
						|
Displays current code version.
 | 
						|
 | 
						|
=item B<-V|--verbose>
 | 
						|
 | 
						|
Displays extra debug information.
 | 
						|
 | 
						|
=item B<-d|--dir>
 | 
						|
 | 
						|
To use a directory other than the default directory,  enter the directory path here.  
 | 
						|
 | 
						|
=item B<-f|--files>
 | 
						|
 | 
						|
Comma separated list of files (full path), wildcard (*) can be used.
 | 
						|
 | 
						|
=item B<File format>
 | 
						|
 | 
						|
The files must be of the form <name>.sql or <name>_<database>.sql  where
 | 
						|
 | 
						|
<database>  is mysql,pgsql, or db2. Files must have permission 0755.  
 | 
						|
 | 
						|
=item I<sql statement>
 | 
						|
 | 
						|
Quoted sql statement syntax appropriate for the current database.
 | 
						|
 | 
						|
=back
 | 
						|
 | 
						|
=head1 EXAMPLES
 | 
						|
 | 
						|
=over 2
 | 
						|
 | 
						|
=item 1.
 | 
						|
To run the database appropriate *.sql files in /opt/xcat/lib/perl/xCAT_schema :
 | 
						|
 | 
						|
 runsqlcmd 
 | 
						|
 | 
						|
=item 2.
 | 
						|
To run the database appropriate *.sql files in /tmp/mysql:
 | 
						|
 | 
						|
 runsqlcmd -d /tmp/mysql
 | 
						|
 | 
						|
=item 3.
 | 
						|
To run the database appropriate *.sql files in the input list:
 | 
						|
 | 
						|
 runsqlcmd -f "/tmp/mysql/test*,/tmp/mysql/test1*"
 | 
						|
 | 
						|
=item 4.
 | 
						|
To checkout one DB2 sql file: 
 | 
						|
 | 
						|
 runsqlcmd -f /tmp/db2/test_db2.sql
 | 
						|
 | 
						|
=item 5.
 | 
						|
To run the following command to the database: 
 | 
						|
 | 
						|
 runsqlcmd "Select * from site;"
 | 
						|
 | 
						|
=back
 |