From 9fd00d35f680d68c8e1575634364acd170ba78da Mon Sep 17 00:00:00 2001 From: lissav Date: Thu, 31 May 2012 14:36:11 +0000 Subject: [PATCH] add new options git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@12973 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man1/pgsqlsetup.1.pod | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/xCAT-client/pods/man1/pgsqlsetup.1.pod b/xCAT-client/pods/man1/pgsqlsetup.1.pod index a31ff3650..4cb556b50 100644 --- a/xCAT-client/pods/man1/pgsqlsetup.1.pod +++ b/xCAT-client/pods/man1/pgsqlsetup.1.pod @@ -9,16 +9,14 @@ B {B<-h>|B<--help>} B {B<-v>|B<--version>} -B {B<-i>|B<--init>} [-o|--setupODBC] [B<-V>|B<--verbose>] +B {B<-i>|B<--init>} [-P|--PCM] [-o|--setupODBC] [B<-V>|B<--verbose>] B {B<-o>|B<--setupODBC>} [-V|--verbose] =head1 DESCRIPTION B - Sets up the PostgreSQL database for xCAT to use. The pgsqlsetup script is run on the Management Node as root after the PostgreSQL code has been installed. The xcatd daemon will be stopped during migration. No xCAT commands should be run during the init process, because we will be migrating the xCAT database to PostgreSQL and restarting the xcatd daemon as well as the PostgreSQL daemon. For full information on all the steps that will be done reference -http://xcat.svn.sourceforge.net/viewvc/xcat/xcat-core/trunk/ -xCAT-client/share/doc/xCAT2SetupPostgresql.pdf. -One password must be supplied for the setup, a password for the xcatadm unix id and the same password for the xcatadm database id. The password will be prompted for interactively. +One password must be supplied for the setup, a password for the xcatadm unix id and the same password for the xcatadm database id. The password will be prompted for interactively or you can set the XCATPGPW environment variable to the password and then there will be no prompt. =head1 OPTIONS @@ -38,11 +36,18 @@ Displays verbose messages. =item B<-i|--init> -The init option is used to setup an installed PostgreSQL database so that xCAT can use the database. This involves creating the xcatdb database, the xcatadm id, allowing access to the xcatdb database by the Management Node. It customizes the postgresql.conf configuration file, adds the management server to the pg_hba.conf and starts the PostgreSQL server. It also backs up the current xCAT database and restores it into the newly setup xcatdb PostgreSQL database. It creates the /etc/xcat/cfgloc file to point the xcatd daemon to the PostgreSQL database and restarts the xcatd daemon using the database. +The init option is used to setup an installed PostgreSQL database so that xCAT can use the database. This involves creating the xcat database, the xcat admin id, allowing access to the xcatdb database by the Management Node. It customizes the postgresql.conf configuration file, adds the management server to the pg_hba.conf and starts the PostgreSQL server. It also backs up the current xCAT database and restores it into the newly setup xcatdb PostgreSQL database. It creates the /etc/xcat/cfgloc file to point the xcatd daemon to the PostgreSQL database and restarts the xcatd daemon using the database. On AIX, it additionally setup the xcatadm unix id and the postgres id and group. For AIX, you should be using the PostgreSQL rpms available from the xCAT website. For Linux, you should use the PostgreSQL rpms shipped with the OS. You can chose the -o option, to run after the init. To add additional nodes to access the PostgreSQL server, setup on the Management Node, edit the pg_hba.conf file. -=item B<-o|--setupODBC> +For more documentation see:https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_PostgreSQL_as_the_xCAT_DB + +=item B<-P|--PCM> + +This option sets up PostgreSQL database to be used with xCAT running with PCM. + + +=item B<-o|--odbc> This option sets up the ODBC /etc/../odbcinst.ini, /etc/../odbc.ini and the .odbc.ini file in roots home directory will be created and initialized to run off the xcatdb PostgreSQL database. @@ -50,6 +55,14 @@ This option sets up the ODBC /etc/../odbcinst.ini, /etc/../odbc.ini and the .od =head1 ENVIRONMENT VARIABLES +=over 4 + +=item B + +The password to be used to setup the xCAT admin id for the database. + +=back + =head1 EXAMPLES =over 2