https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/Recent changes to XCAT_Power_QuickStartenTue, 23 Sep 2014 10:39:06 -0000https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v27 +++ v28 @@ -1,7 +1,7 @@  Note: if you are using P775 hardware, do not use this document. Use: [XCAT_pLinux_Clusters_775]. -For more complete instructions on setting up the cluster. Use: [XCAT_pLinux_Clusters]. +IF you are not very familiar with setting up PLinux clusters, you probably need more complete instructions on setting up the cluster. Use the following documentation. [XCAT_pLinux_Clusters]. [TOC] </pre> </div>Lissa VallettaTue, 23 Sep 2014 10:39:06 -0000https://sourceforge.net8681068dac6f4cc49063ed24a29657b512c7bf29https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v26 +++ v27 @@ -1,6 +1,7 @@  Note: if you are using P775 hardware, do not use this document. Use: [XCAT_pLinux_Clusters_775]. +For more complete instructions on setting up the cluster. Use: [XCAT_pLinux_Clusters]. [TOC] </pre> </div>Lissa VallettaTue, 02 Sep 2014 14:57:35 -0000https://sourceforge.net57cc3a6b0b5950f94c210a216be4a147f796c358https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v25 +++ v26 @@ -1,4 +1,3 @@ -  Note: if you are using P775 hardware, do not use this document. Use: [XCAT_pLinux_Clusters_775]. </pre> </div>Lissa VallettaTue, 12 Aug 2014 13:37:48 -0000https://sourceforge.net36727fcd096fd6ef265de3f22d36f6194388684dhttps://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v24 +++ v25 @@ -1,4 +1,7 @@ -[[img src=Official-xcat-doc.png]] + + + +Note: if you are using P775 hardware, do not use this document. Use: [XCAT_pLinux_Clusters_775]. [TOC] @@ -6,7 +9,7 @@ This guide is a general quick reference for installing xCAT on IBM Power machines. xCAT provides full documentation for many different pLinux scenarios. Start with the information here first, then refer to the specific documentation for your environment if you need more information on commands and detailed setup. -Complete guides: +Complete guide: * [XCAT pLinux Clusters](XCAT_pLinux_Clusters) </pre> </div>Lissa VallettaTue, 12 Aug 2014 13:37:01 -0000https://sourceforge.netf45f7ffb7f25b2958f8d600252d9fb98bf31f205https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v23 +++ v24 @@ -237,7 +237,7 @@ We assume the virtualized partitions (LPARs) are already set using HMC (or IVM). Create nodes for systems and frames under the hmc. (See also stanza files for other ways to configure it. See: -[https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db](https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db) +[XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db](XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db) ~~~~ </pre> </div>Lissa VallettaMon, 14 Jul 2014 16:30:10 -0000https://sourceforge.netcffa762a090d578657634a37578ebdb04d04fa3dhttps://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v22 +++ v23 @@ -99,7 +99,7 @@ 9.3.110.122 aphmc5 aphmc5.austin.ibm.com # HMC ~~~~ -### **[RH] Ensure that SELinux is Disabled** +### Ensure that SELinux is Disabled on RHEL **Note:** you can skip this step in xCAT 2.8.1 and above, because xCAT does it automatically when it is installed. @@ -151,8 +151,8 @@ Check running services. Restart services if necessary. ~~~~ - $ service &lt;name&gt; status - $ service &lt;name&gt; restart + $ service &lt;name&gt; status + $ service &lt;name&gt; restart * httpd @@ -203,7 +203,7 @@ $ tabdump networks #netname,net,mask,mgtifname,gateway,dhcpserver,tftpserver,nameservers,ntpservers,logservers,dynamicrange,nodehostname,ddnsdomain,vlanid,domain,comments,disable "9_3_189_0-255_255_255_0","9.3.189.0","255.255.255.0","eth0","9.3.189.1",,"9.3.189.137",,,,,,,,,, - "192_168_0_0-255_255_255_0","192.168.0.0","255.255.255.0","eth1","&lt;xcatmaster&gt;",,"192.168.0.100",,,,"192.168.0.1-192.168.0.99",,,,,, + "192_168_0_0-255_255_255_0","192.168.0.0","255.255.255.0","eth1","&lt;xcatmaster&gt;",,"192.168.0.100",,,,"192.168.0.1-192.168.0.99",,,,,, ~~~~ </pre> </div>Lissa VallettaMon, 14 Jul 2014 16:28:14 -0000https://sourceforge.net3efc3e850243a66b6f2e153addbeee88ba0766e0https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v21 +++ v22 @@ -239,8 +239,7 @@ Create nodes for systems and frames under the hmc. (See also stanza files for other ways to configure it. See: [https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db](https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db) - http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_System_p_Hardware_Management#Discover_HMCs.2Fframe.2FCECs.2C_and_define_them_in_xCAT_DB) - + ~~~~ $ rscan -w aphmc5 ~~~~ @@ -282,7 +281,7 @@ $ rcons junoltc03 ~~~~ -See [https://sourceforge.net/apps/mediawik.../index.php?title=Debugging_xCAT_Problems](https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Debugging_xCAT_Problems) if you have problems with the console +See [Debugging_xCAT_Problems], if you have problems with the console Get nodes mac addresses. Attention, if you have more than one interface, you need to specify which one you need to write in the `mac` table (See `man getmacs`) @@ -390,10 +389,10 @@ ~~~~ -Trouble with TFTP server, console, remote installation, configuration? See https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Debugging_xCAT_Problems +Trouble with TFTP server, console, remote installation, configuration? See [Debugging_xCAT_Problems] Complete guides: - * http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_pLinux_Clusters - * http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Setting_Up_a_Linux_xCAT_Mgmt_Node + * [XCAT_pLinux_Clusters] + </pre> </div>Lissa VallettaMon, 14 Jul 2014 16:25:59 -0000https://sourceforge.net4563da23905ac56f613101e9a4c306cf1ce70882https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v20 +++ v21 @@ -138,7 +138,7 @@ ### DNS -This quickstart uses DNS configuration setup through /etc/hosts. For other DNS configuration methods,refer to: http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Cluster_Name_Resolution +This quickstart uses DNS configuration setup through /etc/hosts. For other DNS configuration methods,refer to: {Cluster_Name_Resolution] ## Install and Configure xCAT on the Management Node @@ -236,7 +236,10 @@ We assume the virtualized partitions (LPARs) are already set using HMC (or IVM). -Create nodes for systems and frames under the hmc. (See also stanza files for other ways to configure it. See: http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_System_p_Hardware_Management#Discover_HMCs.2Fframe.2FCECs.2C_and_define_them_in_xCAT_DB) +Create nodes for systems and frames under the hmc. (See also stanza files for other ways to configure it. See: +[https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db](https://sourceforge.net/p/xcat/wiki/XCAT_System_p_Hardware_Management_for_HMC_Managed_Systems/#discover-hmcsframececs-and-define-them-in-xcat-db) + + http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_System_p_Hardware_Management#Discover_HMCs.2Fframe.2FCECs.2C_and_define_them_in_xCAT_DB) ~~~~ $ rscan -w aphmc5 </pre> </div>Lissa VallettaMon, 14 Jul 2014 16:22:13 -0000https://sourceforge.net0e5624f0e31314a7254abae4e3f8025ed7466e51https://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v19 +++ v20 @@ -8,7 +8,7 @@ Complete guides: - * http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_pLinux_Clusters + * [XCAT pLinux Clusters](XCAT_pLinux_Clusters) This guide was written using the following setup. Newer versions of Distros and xCAT and other PowerLinux servers should work correctly, but may not have been explicitly tested: @@ -31,7 +31,9 @@ * `rpower, rscan, rinstall, rnetboot` \- interfaces to hardware management operations -See more information at http://sourceforge.net/apps/mediawiki/xcat/index.php?title=Listing_and_Modifying_the_Database +See more information at +[Listing_and_Modifying_the_Database](Listing_and_Modifying_the_Database) + ## Prepare the xCAT Management Node @@ -43,11 +45,11 @@ Add xCAT repositories (xcat-core and xcat-dep): - +~~~~ $ cd /etc/yum.repos.d wget http://sourceforge.net/projects/xcat/files/yum/2.8/xcat-core/xCAT-core.repo wget http://sourceforge.net/projects/xcat/files/yum/xcat-dep/rh6/ppc64/xCAT-dep.repo - +~~~~ Check network configuration @@ -56,6 +58,7 @@ Example: +~~~~ * LAN: * domain: austin.ibm.com * Management Node (MN) IP: 9.3.189.137/24 @@ -66,7 +69,7 @@ * Hostname:junoltc01 * MN IP: 192.168.0.100/24 * HMC: aphmc5.austin.ibm.com (9.3.110.122) - +~~~~ Important files to check: @@ -74,18 +77,18 @@ * `/etc/sysconfig/network-scripts/ifcfg-eth#` : eth0 is configured to LAN, while eth1 is configured to the xCAT private network * `/etc/resolv.conf`: domain should point to the private domain, as well as search. nameservers should have the private MN ip. - +~~~~ $ cat /etc/resolv.conf domain mine.austin.ibm.com search mine.austin.ibm.com nameserver 192.168.0.100 - +~~~~ On xCAT 2.7 or later, you don't to need to configure the /etc/resolv.conf facing the private network. * `/etc/hosts` (see DNS section below for other choices of DNS configuration). It should contain dns resolution information for the management node, compute node(s) and the hmc: - +~~~~ $ cat /etc/hosts ... 192.168.0.100 junoltc01 junoltc01.mine.austin.ibm.com #MN @@ -94,17 +97,18 @@ 9.3.110.122 aphmc5 aphmc5.austin.ibm.com # HMC - +~~~~ ### **[RH] Ensure that SELinux is Disabled** **Note:** you can skip this step in xCAT 2.8.1 and above, because xCAT does it automatically when it is installed. To disable SELinux manually: - + +~~~~ echo 0 &gt; /selinux/enforce sed -i 's/^SELINUX=.*$/SELINUX=disabled/' /etc/selinux/config - +~~~~ ### ** Disable the Firewall** @@ -114,18 +118,20 @@ The management node provides many services to the cluster nodes, but the firewall on the management node can interfere with this. If your cluster is on a secure network, the easiest thing to do is to disable the firewall on the Management Mode: For RH: - + +~~~~ service iptables stop chkconfig iptables off - +~~~~ If disabling the firewall completely isn't an option, configure iptables to allow the following services on the NIC that faces the cluster: DHCP, TFTP, NFS, HTTP, DNS. For SLES: - + +~~~~ SuSEfirewall2 stop - +~~~~ @@ -138,13 +144,13 @@ Install xCAT - +~~~~ $ yum install xCAT - +~~~~ Check running services. Restart services if necessary. - +~~~~ $ service &lt;name&gt; status $ service &lt;name&gt; restart @@ -156,6 +162,8 @@ * xcatd * firewall disabled (all policies accepting all in `iptables -L`) +~~~~ + Check site table Important fields: @@ -168,13 +176,13 @@ To change the site table - +~~~~ $ chdef -t site master=192.168.0.100 domain=mine.austin.ibm.com nameservers=192.168.0.100 forwarders=9.0.7.1,9.0.6.11 dhcpinterfaces=eth1 - +~~~~ To check the site table configuration - +~~~~ $ tabdump site ... "master","192.168.0.100",, @@ -185,41 +193,42 @@ ... "consoleondemand","yes",, - +~~~~ Check networks table No changes needed if the setup above was correctly performed. - +~~~~ $ tabdump networks #netname,net,mask,mgtifname,gateway,dhcpserver,tftpserver,nameservers,ntpservers,logservers,dynamicrange,nodehostname,ddnsdomain,vlanid,domain,comments,disable "9_3_189_0-255_255_255_0","9.3.189.0","255.255.255.0","eth0","9.3.189.1",,"9.3.189.137",,,,,,,,,, "192_168_0_0-255_255_255_0","192.168.0.0","255.255.255.0","eth1","&lt;xcatmaster&gt;",,"192.168.0.100",,,,"192.168.0.1-192.168.0.99",,,,,, - + +~~~~ Define the dynamic range for dhcp server(Optional) The dynamic range is only needed by the hardware discovery process, if you will not do the hardware discovery, setting dynamic range might bring in side-effects for the ip addresses assignment in the network. - +~~~~ $ chdef -t network -o 192_168_0_0-255_255_255_0 dynamicrange="192.168.0.1-192.168.0.99" - +~~~~ Add the default account for root, when nodes are installed. - +~~~~ $ chtab key=system passwd.username=root passwd.password=cluster - +~~~~ Configure the hmc node - +~~~~ $ mkdef -t node -o aphmc groups=hmc,all nodetype=ppc hwtype=hmc mgt=hmc username=hscroot password=abc1234 - +~~~~ @@ -229,53 +238,53 @@ Create nodes for systems and frames under the hmc. (See also stanza files for other ways to configure it. See: http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_System_p_Hardware_Management#Discover_HMCs.2Fframe.2FCECs.2C_and_define_them_in_xCAT_DB) - +~~~~ $ rscan -w aphmc5 - +~~~~ Run make* scripts - +~~~~ $ makeconservercf # enable remote console $ makedhcp -n # configure dhcp server $ makedhcp -a $ makedns # configure dns server - - -See [https://sourceforge.net/apps/mediawik.../index.php?title=Debugging_xCAT_Problems](https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Debugging_xCAT_Problems) for more debugging information on those commands. +~~~~ + +See [Debugging_xCAT_Problems] for more debugging information on those commands. Copy distro image to /install. You need to download the distro image (or mount it using NFS) to a directory in your disk. The example here is using RHEL6.2 (see that xCAT uses rhels6.2), and the ISO image is on /iso/ - +~~~~ $ copycds -n rhels6.2 -a ppc64 /iso/RHEL6.2-20111117.0-Server-ppc64-DVD1.iso $ ls /install/rhels6.2/ppc64 # verify copy was successfull - +~~~~ ### Define and Configure Nodes Add group to identify nodes that will be managed - +~~~~ $ chdef junoltc0[39] groups=cn -p $ lsdef cn -i groups Object name: junoltc03 groups=lpar,all,cn Object name: junoltc09 groups=lpar,all,cn - +~~~~ Test if console is working for nodes - +~~~~ $ rcons junoltc03 - +~~~~ See [https://sourceforge.net/apps/mediawik.../index.php?title=Debugging_xCAT_Problems](https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Debugging_xCAT_Problems) if you have problems with the console Get nodes mac addresses. Attention, if you have more than one interface, you need to specify which one you need to write in the `mac` table (See `man getmacs`) - +~~~~ $ getmacs cn junoltc03: @@ -294,25 +303,28 @@ End definition of nodes - +~~~~ + +~~~~ $ chdef cn netboot=yaboot tftpserver=192.168.0.100 nfsserver=192.168.0.100 xcatmaster=192.168.0.100 installnic="eth1" primarynic="eth1" - +~~~~ Setup nodes for OS deployment Here, we are going to deploy RHEL6.2 - +~~~~ $ chdef cn os=rhel6.2 profile=compute arch=ppc64 - +~~~~ We are ready now to deploy the distro in the compute nodes! ## Deploy the Nodes When you ran copycds, osimage definitions for your distro were automatically created: - + +~~~~ lsdef -t osimage - +~~~~ For basic operating system installations, you can use one of these images without modification. Review the contents of the files referenced by the osimage definition you choose. For image customization, see [Using_Provmethod%3Dosimagename] @@ -320,13 +332,14 @@ ### Stateful (Diskfull) Install Choose and review a stateful osimage definition: - + +~~~~ lsdef -t osimage -o rhels6.2-ppc64-install-compute -l - +~~~~ Set node to diskfull install and run installation: - +~~~~ #TRY THIS $ nodeset junoltc03 osimage=rhels6.2-ppc64-install-compute $ lsdef junoltc03 # check all node parameters are correctly set @@ -338,29 +351,32 @@ # to follow the installation process $ rcons junoltc03 #run from another terminal - +~~~~ ### Stateless (Diskless) Boot You need to generate an installation image before proceeding with netbooting. Review your chosen osimage definition: - + +~~~~ lsdef -t osimage -o rhels6.2-ppc64-netboot-compute -l - +~~~~ Generate and pack your diskless image: - +~~~~ $ genimage rhels6.2-ppc64-install-compute $ packimage rhels6.2-ppc64-install-compute - +~~~~ Set node to diskless install and network boot the node to load the image: - +~~~~ $ nodeset junoltc09 osimage=rhels6.2-ppc64-install-compute $ lsdef junoltc09 # check all node parameters are correctly set ... - +~~~~ + +~~~~ # NETWORK BOOT THE NODE: $ rpower junoltc09 reset # OR @@ -368,7 +384,7 @@ # to follow the installation process $ rcons junoltc09 #run from another terminal - +~~~~ Trouble with TFTP server, console, remote installation, configuration? See https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Debugging_xCAT_Problems </pre> </div>Lissa VallettaMon, 14 Jul 2014 16:18:16 -0000https://sourceforge.net91990faffec9ceee71a532627596a0eaac11762ehttps://sourceforge.net/p/xcat/wiki/XCAT_Power_QuickStart/<div class="markdown_content"><pre>--- v18 +++ v19 @@ -11,7 +11,7 @@ * http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_pLinux_Clusters -This guide refers to the following setup: +This guide was written using the following setup. Newer versions of Distros and xCAT and other PowerLinux servers should work correctly, but may not have been explicitly tested: * Hardware: **Power7** * Hardware Control: **HMC** </pre> </div>Mon, 23 Jun 2014 19:41:23 -0000https://sourceforge.net576c2cd1eef0d7156e2d4465b7bf14805edb7013