Configuration - Revision history

Iskra: /* Downloading */

2022-02-25T19:38:47Z

Downloading

Iskra: /* Downloading */

2022-02-25T19:37:19Z

Downloading

Kazutomo: /* Building */

2009-05-08T16:58:39Z

Building

Iskra at 15:21, 8 May 2009

2009-05-08T15:21:21Z

Iskra: /* Configuring */

2009-05-07T17:53:35Z

Configuring

Iskra: /* Building */

2009-05-06T21:32:07Z

Building

Iskra: /* Building */

2009-05-06T21:15:11Z

Building

Iskra: /* Building */

2009-05-05T22:45:24Z

Building

Iskra at 22:23, 5 May 2009

2009-05-05T22:23:29Z

Iskra: /* Configuring */

2009-05-05T21:30:43Z

Configuring

@@ Line 6: / Line 6: @@
 * Log on one of the front end nodes of the Blue Gene (a login node or a service node).
-* Download the ZeptoOS tarball from the ZeptoOS [https://www.mcs.anl.gov/research/projects/zeptoos/download download page].
+* Download the ZeptoOS tarball from the ZeptoOS [https://www.mcs.anl.gov/research/projects/zeptoos/downloads downloads page].
 * Extract the sources from the package:

@@ Line 6: / Line 6: @@
 * Log on one of the front end nodes of the Blue Gene (a login node or a service node).
-* Download the ZeptoOS tarball from the ZeptoOS [http://press.mcs.anl.gov/zeptoos/download download page].
+* Download the ZeptoOS tarball from the ZeptoOS [https://www.mcs.anl.gov/research/projects/zeptoos/download download page].
 * Extract the sources from the package:

@@ Line 104: / Line 104: @@
 ; bgp-all-pkg-rebuild
 : Rebuilds all packages from sources.
 (the following <tt>make</tt> targets are mostly for internal use)
 ; bgp-ion-linux

@@ Line 4: / Line 4: @@
 == Downloading ==
-* Log on one of the frontend nodes of the Blue Gene (a login node or a service node).
+* Log on one of the front end nodes of the Blue Gene (a login node or a service node).
 * Download the ZeptoOS tarball from the ZeptoOS [http://press.mcs.anl.gov/zeptoos/download download page].
@@ Line 10: / Line 10: @@
 * Extract the sources from the package:
 <pre>
-$ tar xjf ZeptoOS-*.tar.bz2
+$ tar xjf ZeptoOS-<version>.tar.bz2
 </pre>
@@ Line 21: / Line 21: @@
 </pre>
-A <tt>configure</tt> script is provided to set the pathnames to various system directories.
+A <tt>configure</tt> script is provided to set the pathnames to various system directories:
 <pre>
@@ Line 27: / Line 27: @@
 </pre>
-If invoked without any arguments, it will use the defaults, which should be appropriate if ZeptoOS is configured on a system with a supported BG/P driver version.  The pathnames can be changed with the help of a user interface by invoking the script as follows:
+If invoked without any arguments, it will use the defaults, which should be appropriate if ZeptoOS is configured on a system with a supported BG/P driver version.  The pathnames can be changed with the help of a textual user interface by invoking the script as follows:
 <pre>
@@ Line 79: / Line 79: @@
 '''Security note: root-level access to I/O nodes should only be given to trusted individuals.  A root user can access and modify files of all users in the system.'''
-Once a password has been entered and confirmed, <tt>make</tt> will use pre-built kernel images, and will build the ramdisks from pre-built tools and utilities.  The following generated files will be placed in the top-level directory:
+Once the password has been entered and confirmed, <tt>make</tt> will use pre-built kernel images, and will build the ramdisks from pre-built tools and utilities.  The following generated files will be placed in the top-level directory:
 ; BGP-CN-zImage-with-initrd.elf
-: A merged ZeptoOS compute node Linux and compute node ramdisk file.
+: ZeptoOS compute node Linux with embedded compute node ramdisk.
 ; BGP-ION-ramdisk-for-CNL.elf
 : ZeptoOS I/O node ramdisk for use with the ZeptoOS compute node Linux.
 ; BGP-ION-ramdisk-for-CNK.elf
 : ZeptoOS I/O node ramdisk for use with the IBM CNK (optional).
 It is possible to rebuild individual ZeptoOS components using one of the following <tt>make</tt> targets (the list is also available by typing <tt>make help</tt> or <tt>make menu</tt>):
 ; bgp-ion-ramdisk-cnk
 : Rebuilds the I/O node ramdisk for the IBM CNK.
 ; bgp-ion-linux-build
 : Rebuilds the I/O node kernel.
 ; bgp-cn-linux-build
-: Rebuilds the compute node kernel and ramdisk and merges them.
+: Rebuilds the compute node kernel and ramdisk and embeds the ramdisk into the kernel.
 ; bgp-all-pkg-rebuild
 : Rebuilds all packages from sources.
-(the following <tt>make</tt>targets are mostly for internal use)
+(the following <tt>make</tt> targets are mostly for internal use)
 ; bgp-ion-linux
 : Copies a recently rebuilt I/O node kernel if one is available; otherwise, uses a prebuilt binary (will not rebuild the kernel).

@@ Line 15: / Line 15: @@
 == Configuring ==
-Change to the top-level <tt>BGP</tt> directory:
+Change to the top-level <tt>ZeptoOS-<version></tt> directory:
 <pre>
-$ cd BGP/
+$ cd ZeptoOS-<version>
 </pre>

@@ Line 96: / Line 96: @@
 ; bgp-ion-ramdisk-cnl
 : Rebuilds the I/O node ramdisk for the ZeptoOS compute node Linux.
 ; bgp-ion-linux-build
 : Rebuilds the I/O node kernel.
@@ Line 105: / Line 107: @@
 ; bgp-ion-linux
 : Copies a recently rebuilt I/O node kernel if one is available; otherwise, uses a prebuilt binary (will not rebuild the kernel).
 ; bgp-all-pkg-smart
 : Copies recently rebuilt packages if available; otherwise, uses prebuilt binaries (used when preparing to rebuild ramdisks).

@@ Line 10: / Line 10: @@
 * Extract the sources from the package:
 <pre>
-tar xjf ZeptoOS-*.tar.bz2
+$ tar xjf ZeptoOS-*.tar.bz2
 </pre>
@@ Line 21: / Line 21: @@
 </pre>
-A <tt>configure</tt> script is provided to set the pathnames to various system directories.  If invoked without any arguments, it will use the defaults, which should be appropriate if ZeptoOS is configured on a system with a supported BG/P driver version.  The pathnames can be changed with the help of a user interface by invoking the script as follows:
+A <tt>configure</tt> script is provided to set the pathnames to various system directories.
 <pre>
@@ Line 31: / Line 37: @@
 [[Image:Configure1.png|border|Main menu]]
-Please select the top item (<tt>BG/P DIST_DIR</tt>); <tt>KTAU</tt> is discussed in the [[(K)TAU#Configure ZeptoOS to point to KTAU patch and path|(K)TAU section]].  The screen will change to:
+Please select the top item (<tt>BG/P DIST_DIR</tt>).  The screen will change to:
 [[Image:Configure2.png|border|DIST_DIR menu]]
@@ Line 46: / Line 52: @@
 : The directory with the supplementary I/O node software used when booting the I/O nodes.  It needs to be set to match the BG/P driver version being used.
-== Building ==
+The second top-level menu (<tt>Debugging</tt>) has only one option:
-Typing ''make help'' will bring up the following menu:
+; ADD_DEBUG_TOOLS
-<pre>
+: Check this option to include <tt>gdb</tt> and <tt>strace</tt> in the compute node ramdisk.  They are not included by default because of their size.
-make                       - Prepare Zepto kernel and ramdisk images
+The third top-level menu (<tt>Kernel Profiling</tt>) is discussed in the [[(K)TAU#Configure ZeptoOS to point to KTAU patch and path|(K)TAU section]]
-make bgp-ion-ramdisk-cnk   - Rebuild ION ramdisk for CNK
+Select <tt>Exit</tt> (multiple times if needed) and confirm if you want to save any changes made.
-make bgp-ion-linux         - Simply use recent built or prebuilt ION kernel (no kernel rebuild)
+== Building ==
-make bgp-ion-linux-build   - Rebuild ION kernel
+To start using the pre-built binaries simply type:
-make bgp-all-pkg-smart     - Build packages from the prebuilt binaries
+<pre>
-make bgp-all-pkg-rebuild   - Rebuild all packages from source
+$ make
 </pre>
-To start using the default built binaries simply type:
+On the first invocation, this will ask for a root password to use on I/O nodes:
 <pre>
-$ ls -l
+Create root password for I/O Node
--rwxr-xr-x  1 hnaik users  8629983 2009-01-23 17:16 BGP-CN-zImage-with-initrd.elf
+   Leave the password field empty if you want to disable root login
--rwxr-xr-x  1 hnaik users  1444183 2009-01-23 17:03 BGP-exp-ION-zImage.elf
+   New password:
 </pre>
 ----
 [[Introduction]] | [[ZeptoOS_Documentation|Top]] | [[Installation]]