From 7203b4db08f8f60cff8fff02c36e0a8b227d01d3 Mon Sep 17 00:00:00 2001 From: lissav Date: Tue, 29 Jul 2014 12:00:20 -0400 Subject: [PATCH 1/3] fix comments --- perl-xCAT/xCAT/Schema.pm | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/perl-xCAT/xCAT/Schema.pm b/perl-xCAT/xCAT/Schema.pm index 42405c2be..800481808 100755 --- a/perl-xCAT/xCAT/Schema.pm +++ b/perl-xCAT/xCAT/Schema.pm @@ -1160,9 +1160,9 @@ site => { " locking out admin interactive use. This value works with the\n". " xcatmaxconnections and xcatmaxbatch attributes. Is not supported on AIX.\n". " If the value is no, nodes sleep for a random time before contacting\n". - " xcatd, and retry. On a new install of xcat, this value will be set to yes.\n". + " xcatd, and retry. The default is no.\n". " See the following document for details:\n". - " https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Hints_and_Tips_for_Large_Scale_Clusters\n\n". + " Hints_and_Tips_for_Large_Scale_Clusters\n\n". " xcatmaxconnections: Number of concurrent xCAT protocol requests before requests\n". " begin queueing. This applies to both client command requests\n". " and node requests, e.g. to get postscripts. Default is 64.\n\n". From a03ecf8daa2e1b6938c6455498104ab636665cd5 Mon Sep 17 00:00:00 2001 From: lissav Date: Tue, 29 Jul 2014 12:16:06 -0400 Subject: [PATCH 2/3] remove mediawiki path from the man pages --- xCAT-client/pods/man1/configfpc.1.pod | 2 +- xCAT-client/pods/man1/db2sqlsetup.1.pod | 2 +- xCAT-client/pods/man1/geninitrd.1.pod | 2 +- xCAT-client/pods/man1/lsvm.1.pod | 4 ++-- xCAT-client/pods/man1/mysqlsetup.1.pod | 6 +++--- xCAT-client/pods/man1/pgsqlsetup.1.pod | 2 +- xCAT-client/pods/man1/rflash.1.pod | 10 +++++----- xCAT-client/pods/man1/updatenode.1.pod | 10 +++++----- xCAT-client/pods/man1/xdcp.1.pod | 2 +- 9 files changed, 20 insertions(+), 20 deletions(-) diff --git a/xCAT-client/pods/man1/configfpc.1.pod b/xCAT-client/pods/man1/configfpc.1.pod index a426275c5..390cbc978 100644 --- a/xCAT-client/pods/man1/configfpc.1.pod +++ b/xCAT-client/pods/man1/configfpc.1.pod @@ -25,7 +25,7 @@ The B command discovers the FPCs and collects the MAC address. The MA This process is repeated until no more FPCs are discovered. For more information on xCAT support of NeXtScale and configfpc see: -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_NeXtScale_Clusters +XCAT_NeXtScale_Clusters =head1 OPTIONS diff --git a/xCAT-client/pods/man1/db2sqlsetup.1.pod b/xCAT-client/pods/man1/db2sqlsetup.1.pod index 2127ccb3c..5b1f5195d 100644 --- a/xCAT-client/pods/man1/db2sqlsetup.1.pod +++ b/xCAT-client/pods/man1/db2sqlsetup.1.pod @@ -24,7 +24,7 @@ The xcatd daemon will be stopped during migration on the MN. No xCAT commands s The db2sqlsetup script must be run on each Service Node, after the DB2 Client code has been installed, to setup the DB2 Client (-C). There are two postscripts that are provided ( db2install and odbcsetup) that will automatically setup you Service Node as a DB2 client. -For full information on the setup of DB2, see http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_DB2_as_the_xCAT_DB. +For full information on the setup of DB2, see Setting_Up_DB2_as_the_xCAT_DB. When running of db2sqlsetup on the MN: One password must be supplied for the setup, a password for the xcatdb unix id which will be used as the DB2 instance id and database name. The password will be prompted for interactively or can be input with the XCATDB2PW environment variable. diff --git a/xCAT-client/pods/man1/geninitrd.1.pod b/xCAT-client/pods/man1/geninitrd.1.pod index 9af58234a..5f4753267 100644 --- a/xCAT-client/pods/man1/geninitrd.1.pod +++ b/xCAT-client/pods/man1/geninitrd.1.pod @@ -38,7 +38,7 @@ B - comma separated 'osdistroupdate' object. Each 'osdistroupdate' Linux distro update. When run geninitrd, 'kernel-*.rpm' will be searched from osdistroupdate.dirpath to get all the rpm packages and then search the drivers from the rpm packages. -Refer to the doc: https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Using_Linux_Driver_Update_Disk +Refer to the doc: Using_Linux_Driver_Update_Disk =back diff --git a/xCAT-client/pods/man1/lsvm.1.pod b/xCAT-client/pods/man1/lsvm.1.pod index 652c03721..0ff6d3651 100644 --- a/xCAT-client/pods/man1/lsvm.1.pod +++ b/xCAT-client/pods/man1/lsvm.1.pod @@ -41,8 +41,8 @@ The Memory Interleaving Mode has 3 valid options: 1 - interleaved 2 - non-interleaved -More information about this part, refer to the section Using the *vm commands to define partitions in xCAT DFM in the link below. - https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Power_775_Hardware_Management +More information about this part, refer to the section Using the *vm commands to define partitions in xCAT DFM in the doc below. + XCAT_Power_775_Hardware_Management =head2 For KVM and Vmware diff --git a/xCAT-client/pods/man1/mysqlsetup.1.pod b/xCAT-client/pods/man1/mysqlsetup.1.pod index fc6addb57..b09cecfc9 100644 --- a/xCAT-client/pods/man1/mysqlsetup.1.pod +++ b/xCAT-client/pods/man1/mysqlsetup.1.pod @@ -20,7 +20,7 @@ B {B<-L>|B<--LL>} [-V|--verbose] =head1 DESCRIPTION B - Sets up the MySQL or MariaDB database (linux only for MariaDB) for xCAT to use. The mysqlsetup script is run on the Management Node as root after the MySQL code or MariaDB code has been installed. Before running the init option, the MySQL server should be stopped, if it is running. The xCAT daemon, xcatd, must be running, do not stop it. No xCAT commands should be run during the init process, because we will be migrating the xCAT database to MySQL or MariaDB and restarting the xcatd daemon as well as the MySQL daemon. For full information on all the steps that will be done, read the "Configure MySQL and Migrate xCAT Data to MySQL" sections in -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_MySQL_as_the_xCAT_DB +Setting_Up_MySQL_as_the_xCAT_DB Two passwords must be supplied for the setup, a password for the xcatadmin id and a password for the root id in the MySQL database. These will be prompted for interactively, unless the environment variables XCATMYSQLADMIN_PW and XCATMYSQLROOT_PW are set to the passwords for the xcatadmin id and root id in the database,resp. Note below we refer to MySQL but it works the same for MariaDB. @@ -57,13 +57,13 @@ This option runs during update, it will take all the host from the input file (p 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 MySQL database. See "Add ODBC Support" in -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_MySQL_as_the_xCAT_DB +Setting_Up_MySQL_as_the_xCAT_DB =item B<-L|--LL> Additional database configuration specifically for the LoadLeveler product. See "Add ODBC Support" in -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_MySQL_as_the_xCAT_DB +Setting_Up_MySQL_as_the_xCAT_DB =back diff --git a/xCAT-client/pods/man1/pgsqlsetup.1.pod b/xCAT-client/pods/man1/pgsqlsetup.1.pod index d3077ec1a..b33d77724 100644 --- a/xCAT-client/pods/man1/pgsqlsetup.1.pod +++ b/xCAT-client/pods/man1/pgsqlsetup.1.pod @@ -40,7 +40,7 @@ The init option is used to setup an installed PostgreSQL database so that xCAT c 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. -For more documentation see:https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_PostgreSQL_as_the_xCAT_DB +For more documentation see:Setting_Up_PostgreSQL_as_the_xCAT_DB =item B<-N|--nostart> diff --git a/xCAT-client/pods/man1/rflash.1.pod b/xCAT-client/pods/man1/rflash.1.pod index 8ea127c73..07dc4dfc2 100644 --- a/xCAT-client/pods/man1/rflash.1.pod +++ b/xCAT-client/pods/man1/rflash.1.pod @@ -60,8 +60,8 @@ If it outputs B<"Timeout waiting for prompt"> during the upgrade, please set the In currently Direct FSP/BPA Management, our B doesn't support B value of B<--activate> flag, and supports B and B. The B option will cause any affected systems that are powered on to be powered down before installing and activating the update. So we require that the systems should be powered off before do the firmware update. -The B option will load the new firmware into the T (temp) side, but will not activate it like the disruptive firmware. The customer will continue to run the Frames and CECs working with the P (perm) side and can wait for a maintenance window where they can activate and boot the Frame/CECs with new firmware levels. Refer to the link to get more details: - https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Power_775_Hardware_Management#Perform_Deferred_Firmware_upgrades_for_frame.2FCEC_on_Power_775 +The B option will load the new firmware into the T (temp) side, but will not activate it like the disruptive firmware. The customer will continue to run the Frames and CECs working with the P (perm) side and can wait for a maintenance window where they can activate and boot the Frame/CECs with new firmware levels. Refer to the doc to get more details: + XCAT_Power_775_Hardware_Management In Direct FSP/BPA Management, there is -d option. The default value is /tmp. When do firmware update, rflash will put some related data from rpm packages in directory, so the execution of rflash will require available disk space in for the command to properly execute: @@ -71,12 +71,12 @@ For one GFW rpm package and one power code rpm package , if the GFW rpm package For Power 775, the rflash command takes effect on the primary and secondary FSPs or BPAs almost in parallel. For more details about the Firmware Update using Direct FSP/BPA Management, refer to: - https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Power_775_Hardware_Management#Updating_the_BPA_and_FSP_firmware_using_xCAT_DFM + XCAT_Power_775_Hardware_Management#Updating_the_BPA_and_FSP_firmware_using_xCAT_DFM =head2 NeXtScale FPC specific: -The command will update firmware for NeXtScale FPC when given an FPC node and the http information needed to access the firmware. The http imformation required includes both the MN IP address as well as the directory containing the firmware. It is recommended that the firmware be downloaded and placed in the /install directory structure as the xCAT MN /install directory is configured with the correct permissions for http. Refer to the link to get more details: - https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_NeXtScale_Clusters#Update_the_FPC_firmware_.28optional.29 +The command will update firmware for NeXtScale FPC when given an FPC node and the http information needed to access the firmware. The http imformation required includes both the MN IP address as well as the directory containing the firmware. It is recommended that the firmware be downloaded and placed in the /install directory structure as the xCAT MN /install directory is configured with the correct permissions for http. Refer to the doc to get more details: + XCAT_NeXtScale_Clusters =head1 B diff --git a/xCAT-client/pods/man1/updatenode.1.pod b/xCAT-client/pods/man1/updatenode.1.pod index bf758eaa9..b7e189f7a 100644 --- a/xCAT-client/pods/man1/updatenode.1.pod +++ b/xCAT-client/pods/man1/updatenode.1.pod @@ -89,7 +89,7 @@ Files may be distributed and synchronized for both diskless and diskfull nodes. Syncing files to NFS-based statelite nodes is not supported. More information on using the synchronization file function is in -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Using_Updatenode. +Using_Updatenode. =head3 Create the synclist file @@ -100,7 +100,7 @@ and the destination location for the files on the target node. For more information on creating your synclist files and where to put them, read: -http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Sync-ing_Config_Files_to_Nodes +Sync-ing_Config_Files_to_Nodes =head3 Run updatenode to synchronize the files @@ -111,7 +111,7 @@ http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Sync-ing_Config_Files =head2 To install or update software updatenode can be use to install or update software on the nodes. See the following documentation for setting up otherpkgs: -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Install_Additional_Packages +Install_Additional_Packages To install/update the packages, run: @@ -136,9 +136,9 @@ B Note: The updatenode command is used to update AIX diskfull nodes only. For updating diskless AIX nodes refer to the xCAT for AIX update documentation and use the xCAT mknimimage command. For information on updating software on AIX cluster: For diskful installs, read: -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_AIX_RTE_Diskfull_Nodes +XCAT_AIX_RTE_Diskfull_Nodes For diskless installs, read: -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_AIX_Diskless_Nodes +XCAT_AIX_Diskless_Nodes =head2 To run postscripts diff --git a/xCAT-client/pods/man1/xdcp.1.pod b/xCAT-client/pods/man1/xdcp.1.pod index dab5ca684..2213eccc8 100644 --- a/xCAT-client/pods/man1/xdcp.1.pod +++ b/xCAT-client/pods/man1/xdcp.1.pod @@ -205,7 +205,7 @@ For example, your rsynclist file may look like this: Note: no order can be assumed by the order that the EXECUTE,EXECUTEALWAYS and APPEND clause fall in the synclist file. -For more information on syncing files to node, read https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Sync-ing_Config_Files_to_Nodes +For more information on syncing files to node, read Sync-ing_Config_Files_to_Nodes On Linux rsync always uses ssh remoteshell. On AIX, ssh or rsh is used depending on the site.useSSHonAIX attribute. From 8e06c3fb2302eb75387266099025149256353a72 Mon Sep 17 00:00:00 2001 From: lissav Date: Tue, 29 Jul 2014 12:17:19 -0400 Subject: [PATCH 3/3] remove mediawiki path from the man pages --- xCAT-client/pods/man8/makedns.8.pod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xCAT-client/pods/man8/makedns.8.pod b/xCAT-client/pods/man8/makedns.8.pod index 3674161d7..71ad50457 100644 --- a/xCAT-client/pods/man8/makedns.8.pod +++ b/xCAT-client/pods/man8/makedns.8.pod @@ -31,7 +31,7 @@ Only entries in /etc/hosts or the hosts specified by B that have a co By default, B sets up the B service and updates the DNS records on the local system (management node). If the -e flag is specified, it will also update the DNS records on any external DNS server that is listed in the /etc/resolv.conf on the management node. (Assuming the external DNS server can recognize the xCAT key as authentication.) For more information on Cluster Name Resolution: -https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Cluster_Name_Resolution +Cluster_Name_Resolution =head1 OPTIONS