Recent changes to Ubuntu_Quick_Start

Ubuntu_Quick_Start modified by Peng Yang

Peng Yang — Fri, 11 Sep 2015 02:57:27 -0000

--- v141
+++ v142
@@ -218,7 +218,7 @@
 **Has Internet Access**

 ~~~~
-# install the add-apt-repository command
+# Install the add-apt-repository command
 apt-get install software-properties-common

 # For x86_64:

Ubuntu_Quick_Start modified by BaiYuan

BaiYuan — Wed, 19 Aug 2015 07:15:38 -0000

--- v140
+++ v141
@@ -462,7 +462,7 @@

  
 **NOTE for Diskless:** Since we need the **First HTTP Mirror** in osimage.pkgdir to generate Ubuntu osimage bootstraps, the **First HTTP Mirror** must be a full repository instead of a update one like '
-trusty-updates'. pkgdir format support multiple local/remote http mirror, its format cannot be directory, invalid format like /install/ubuntu14.04.1/x86_64/.   
+trusty-updates'. **pkgdir format** support multiple local/remote http mirror, its format cannot be directory, invalid format like /install/ubuntu14.04.1/x86_64/.   

  
 **Install Otherpkgs**

Ubuntu_Quick_Start modified by BaiYuan

BaiYuan — Wed, 19 Aug 2015 07:13:51 -0000

--- v139
+++ v140
@@ -457,12 +457,12 @@
 For the target osimage, you can specify multiple local http mirror to the osimage.pkgdir attribute.

 ~~~~
-  chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir='/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/ trusty main,http://10.3.5.36/install/ubuntu-ports/ trusty-updates main'
+  chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir='http://10.3.5.36/install/ubuntu-ports/ trusty main,http://10.3.5.36/install/ubuntu-ports/ trusty-updates main'
 ~~~~

  
 **NOTE for Diskless:** Since we need the **First HTTP Mirror** in osimage.pkgdir to generate Ubuntu osimage bootstraps, the **First HTTP Mirror** must be a full repository instead of a update one like '
-trusty-updates'.
+trusty-updates'. pkgdir format support multiple local/remote http mirror, its format cannot be directory, invalid format like /install/ubuntu14.04.1/x86_64/.   

  
 **Install Otherpkgs**

Ubuntu_Quick_Start modified by Victor Hu

Victor Hu — Mon, 16 Mar 2015 12:35:28 -0000

--- v138
+++ v139
@@ -24,6 +24,24 @@
 Obtain Ubuntu Server ISO from the Ubuntu download page and install onto the management node (mn01).

 It is recommended that the management node have connectivity to the internet in order to access various external repositories for package management.  (Refer to Ubuntu's [Repositories/CommandLine](https://help.ubuntu.com/community/Repositories/CommandLine) page for more information).
+
+ 
+
+### Configure the system shell
+
+From Ubuntu 6.10 onwards, the default system shell has been changed from /bin/sh to /bin/dash.   (For more information, refer to [DashAsBinSh](https://wiki.ubuntu.com/DashAsBinSh)). xCAT's shell scripts have been tested and developed using bash.  Please switch to /bin/bash using one of the following commands:
+
+~~~~
+    cd /bin/ && ln -fs bash sh
+~~~~
+
+or
+
+~~~~
+    dpkg-reconfigure dash
+~~~~
+
+and select no

  
 ### Configure the network interface

Ubuntu_Quick_Start modified by XiaoPeng Wang

XiaoPeng Wang — Fri, 13 Feb 2015 03:30:06 -0000

--- v137
+++ v138
@@ -75,7 +75,7 @@

 ### Obtaining xCAT Software

-#### Option 1: Configure the xCAT Software Internet-Hosted Repository
+#### Option 1: Configure the xCAT Software Internet-Hosted Repository (Has Internet Access)

 xCAT provides internet hosted software repositories for xcat-core and xcat-dep (dependencies) software packages.  

@@ -120,7 +120,7 @@
 ~~~~    

  
-#### Option 2: Download the xCAT Software
+#### Option 2: Download the xCAT Software (Has not Internet Access on your xCAT Management Node)

 Download the xCAT core (Linux - Deb Package) and xCAT Dependency package from the [xCAT Download](Download_xCAT) page:

@@ -181,14 +181,23 @@

 Without the key, running 'apt-get update' will display the following error message:  *The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 20E475A8DA736C68*

+**Has Internet Access**
+
 ~~~~    
 wget -O - "http://sourceforge.net/projects/xcat/files/ubuntu/apt.key/download" | apt-key add -
 ~~~~    

+**Has NOT Internet Access**
+
+Download the key file from http://sourceforge.net/projects/xcat/files/ubuntu/apt.key/download and copy it to your xCAT MN, then import it with 'apt-key add' command.
+
+
  
 ### Configure Ubuntu Package repositories

 The xCAT software has dependencies on various Ubuntu operating system packages and using apt-get will automatically pull in those dependencies.  The main and universe repositories must be configured for this to work well.  The following commands will add the necessary apt-repositories to the management node:
+
+**Has Internet Access**

 ~~~~
 # install the add-apt-repository command
@@ -207,6 +216,9 @@
 add-apt-repository "deb http://ports.ubuntu.com/ubuntu-ports $(lsb_release -sc)-updates universe"
 ~~~~

+**Has NOT Internet Access**
+
+Refer to the doc [installing-other-packages-with-ubuntu-official-mirrors](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror) to set up your local mirror.

  
 ### Install xCAT
@@ -306,13 +318,15 @@
 #
 # list out the osimages created
 #
-lsdef -t osimage 
+#lsdef -t osimage 
 ubuntu14.04.1-x86_64-install-compute  (osimage)
 ubuntu14.04.1-x86_64-install-hpc  (osimage)
 ubuntu14.04.1-x86_64-install-kvm  (osimage)
 ubuntu14.04.1-x86_64-netboot-compute  (osimage)
 ubuntu14.04.1-x86_64-statelite-compute  (osimage)

+# list the detail information of certain osimage
+#lsdef -t osimage ubuntu14.04.1-x86_64-install-compute
 ~~~~

 Repeat the above for each operating system you want to provision using xCAT.  
@@ -396,9 +410,9 @@
 makedhcp cn01,cn02
 ~~~~

-
+ 
 ### Use Ubuntu Local Mirror
-For ubuntu, the installation ISO only includes a quite limited subset of the packages in the ubuntu official mirror. To install some essential or latest packages included in the mirrors but not in the ISO during provisioning, the Internet ubuntu official mirror can be added to the "pkgdir" attribute of osimage.
+For ubuntu, the installation ISO only includes a quite limited subset of the packages in the ubuntu official mirror. To install some essential or latest packages included in the mirrors but not in the ISO during provisioning, you can add certain Internet ubuntu official mirror to the "pkgdir" attribute of osimage.

 Take ubuntu 14.04.1 LTS for example, this can be done with the following command:

@@ -408,33 +422,32 @@

 As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. 

-If you can NOT access Internet and have a local mirror created, refer to the following steps to enable the local mirror repository.
-
-* Prerequisite
-
-Set up your local mirror first. See **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.
-
-xCAT only supports the local mirror to be http format. So you must set up your local mirror in a local http server. 
+If you can NOT access Internet and want to use local mirror, refer to the following steps to enable the local mirror repository.
+
+ 
+**Prerequisite**
+
+Set up your local mirror first. Refer to doc **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.
+
+xCAT ONLY supports the local mirror to be http format. So you must set up your local mirror in a local http server. 

 For example: My local http server is 10.3.5.36, I set up a local mirror with URL 'http://10.3.5.36/install/ubuntu-ports/'.

-* For Diskfull Osimage
-
-For diskfull osimage, you must specify the full path of local mirror to the osimage.pkgdir attribute. Diskfull osimage supports multiple http mirror paths.
-
-~~~~
-  pkgdir=/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/ trusty main,http://10.3.5.36/install/ubuntu-ports/ trusty-updates main
-~~~~
-
-* For Diskless Osimage
-
-For diskless osimage, you can just specify the URL of the mirror path (without distribute and components name). And it only support ONE http mirror path.
-
-~~~~
-pkgdir=/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/
-~~~~
-
-* Install Otherpkgs
+ 
+**Set local mirror path to osimage.pkgdir**
+
+For the target osimage, you can specify multiple local http mirror to the osimage.pkgdir attribute.
+
+~~~~
+  chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir='/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/ trusty main,http://10.3.5.36/install/ubuntu-ports/ trusty-updates main'
+~~~~
+
+ 
+**NOTE for Diskless:** Since we need the **First HTTP Mirror** in osimage.pkgdir to generate Ubuntu osimage bootstraps, the **First HTTP Mirror** must be a full repository instead of a update one like '
+trusty-updates'.
+
+ 
+**Install Otherpkgs**

 There's doc to describe how to use Internet mirror to install otherpkgs. See [installing-other-packages-with-ubuntu-official-mirrors](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror)

@@ -444,17 +457,8 @@
 ### Installing Stateful/Diskful Nodes

-A stateful, or diskful, node is a node where the operating system is installed onto the physical disk (hard drive).  The state of the operating system is saved onto the disks and will persist on subsequent reboots. 
-
-A few default osimages are created when the copycds command is run and the names are in the form:
-
-~~~~
-#
-# xCAT created stateful/diskful osimages have <provmethod>=install
-#
-<releasename>-<arch>-<provmethod>-<profile>
-~~~~
-   
+A stateful or diskful node is a node where the operating system is installed onto the physical disk (hard drive).  The state of the operating system is saved onto the disks and will be persistent on subsequent reboots. 
+
  
 #### Begin Installation

@@ -506,16 +510,7 @@
  
 ### Installing Stateless/Diskless Nodes

-A stateless, or diskless, node is a node where the operating system is installed into memory.  The state of the machine is held in memory (RAM) and will not persist on subsequent reboots of the node.  The state will return to what has been set in the master image. 
- 
-A few default osimages are created when the copycds command is run and the names are in the form:
-
-~~~~
-#
-# xCAT created stateless/diskless osimages have <provmethod>=netboot
-#
-<releasename>-<arch>-<provmethod>-<profile>
-~~~~
+A stateless or diskless node is a node where the operating system is installed into memory.  The state of the machine is held in memory (RAM) and will not persist on subsequent reboots of the node.  The state will return to what has been set in the master image. 

  
 #### Prepare Images

Ubuntu_Quick_Start modified by XiaoPeng Wang

XiaoPeng Wang — Tue, 10 Feb 2015 09:40:39 -0000

--- v136
+++ v137
@@ -396,6 +396,50 @@
 makedhcp cn01,cn02
 ~~~~

+
+### Use Ubuntu Local Mirror
+For ubuntu, the installation ISO only includes a quite limited subset of the packages in the ubuntu official mirror. To install some essential or latest packages included in the mirrors but not in the ISO during provisioning, the Internet ubuntu official mirror can be added to the "pkgdir" attribute of osimage.
+ 
+Take ubuntu 14.04.1 LTS for example, this can be done with the following command:
+
+~~~~
+ chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main,http://ports.ubuntu.com/ubuntu-ports trusty-updates main"
+~~~~
+
+As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. 
+
+If you can NOT access Internet and have a local mirror created, refer to the following steps to enable the local mirror repository.
+
+* Prerequisite
+
+Set up your local mirror first. See **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.
+
+xCAT only supports the local mirror to be http format. So you must set up your local mirror in a local http server. 
+
+For example: My local http server is 10.3.5.36, I set up a local mirror with URL 'http://10.3.5.36/install/ubuntu-ports/'.
+
+* For Diskfull Osimage
+
+For diskfull osimage, you must specify the full path of local mirror to the osimage.pkgdir attribute. Diskfull osimage supports multiple http mirror paths.
+
+~~~~
+  pkgdir=/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/ trusty main,http://10.3.5.36/install/ubuntu-ports/ trusty-updates main
+~~~~
+
+* For Diskless Osimage
+
+For diskless osimage, you can just specify the URL of the mirror path (without distribute and components name). And it only support ONE http mirror path.
+
+~~~~
+pkgdir=/install/ubuntu14.04.1/ppc64el,http://10.3.5.36/install/ubuntu-ports/
+~~~~
+
+* Install Otherpkgs
+
+There's doc to describe how to use Internet mirror to install otherpkgs. See [installing-other-packages-with-ubuntu-official-mirrors](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror)
+
+You can replace the internet mirror with local http mirror to do the ohter packages install.
+
  
 ### Installing Stateful/Diskful Nodes

@@ -410,15 +454,6 @@
 #
 <releasename>-<arch>-<provmethod>-<profile>
 ~~~~
-
-For ubuntu, the installation ISO only includes a quite limited subset of the packages in the ubuntu official mirror. To install some essential or latest packages included in the mirrors but not in the ISO during provisioning, the ubuntu official mirror can be added to the "pkgdir" attribute of the osimage. 
-Take ubuntu 14.04.1 LTS for example, this can be done with the following command:
-
-~~~~
- chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main,http://ports.ubuntu.com/ubuntu-ports trusty-updates main"
-~~~~
-
-As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. See **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.

  
 #### Begin Installation

Ubuntu_Quick_Start modified by yangsong

yangsong — Fri, 06 Feb 2015 07:23:38 -0000

--- v135
+++ v136
@@ -415,7 +415,7 @@
 Take ubuntu 14.04.1 LTS for example, this can be done with the following command:

 ~~~~
- chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main, http://ports.ubuntu.com/ubuntu-ports trusty-updates  main"
+ chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main,http://ports.ubuntu.com/ubuntu-ports trusty-updates main"
 ~~~~

 As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. See **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.

Ubuntu_Quick_Start modified by yangsong

yangsong — Thu, 05 Feb 2015 08:37:39 -0000

--- v134
+++ v135
@@ -418,7 +418,7 @@
  chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main, http://ports.ubuntu.com/ubuntu-ports trusty-updates  main"
 ~~~~

-As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. See Appendix B for the steps to create local ubuntu official mirror.
+As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. See **[Installing_other_packages_with_Ubuntu_official_mirror](https://sourceforge.net/p/xcat/wiki/Installing_other_packages_with_Ubuntu_official_mirror/)** for the steps to create local ubuntu official mirror.

  
 #### Begin Installation

Ubuntu_Quick_Start modified by yangsong

yangsong — Thu, 05 Feb 2015 08:31:18 -0000

--- v133
+++ v134
@@ -411,7 +411,15 @@
 <releasename>-<arch>-<provmethod>-<profile>
 ~~~~

-
+For ubuntu, the installation ISO only includes a quite limited subset of the packages in the ubuntu official mirror. To install some essential or latest packages included in the mirrors but not in the ISO during provisioning, the ubuntu official mirror can be added to the "pkgdir" attribute of the osimage. 
+Take ubuntu 14.04.1 LTS for example, this can be done with the following command:
+
+~~~~
+ chdef -t osimage -o ubuntu14.04.1-ppc64el-install-compute -p pkgdir="http://ports.ubuntu.com/ubuntu-ports trusty main, http://ports.ubuntu.com/ubuntu-ports trusty-updates  main"
+~~~~
+
+As shown above, the installation with ubuntu official mirror requires the internet access. In the environment without internet access, a local mirror can be used instead of the online ubuntu official mirror. See Appendix B for the steps to create local ubuntu official mirror.
+   
  
 #### Begin Installation

Ubuntu_Quick_Start modified by Victor Hu

Victor Hu — Mon, 26 Jan 2015 16:41:18 -0000

--- v132
+++ v133
@@ -431,7 +431,7 @@
 ~~~~

  
-**Note:** You man encounter an error when running nodeset command where the initrd.gz file is not found for netboot.  This is required for Ubuntu to successfully boot from network.  It's provided by Ubuntu in a mini.iso file at http://cdimage.ubuntu.com/netboot/14.04/  Download and copy the ../install/initrd.gz file to the netboot directory: 
+**Note:** You may encounter an error when running nodeset command where the initrd.gz file is not found for netboot.  This is required for Ubuntu to successfully boot from network.  It's provided by Ubuntu in a mini.iso file at http://cdimage.ubuntu.com/netboot/14.04/  Download and copy the ../install/initrd.gz file to the netboot directory: 

 ~~~~
 #