Configuration

Introduction | Top | Installation

---

Downloading

• Log on one of the frontend nodes of the Blue Gene (a login node or a service node).

• Download the ZeptoOS tarball from the ZeptoOS download page.

• Extract the sources from the package:

tar xjf ZeptoOS-*.tar.bz2

Configuring

Change to the top-level BGP directory:

$ cd BGP/

A configure 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:

$ ./configure --edit

This will display the following menu:

Please select the top item (BG/P DIST_DIR); KTAU is discussed in the (K)TAU section. The screen will change to:

The following options are available:

DRV_DIR

The directory with the BG/P driver tree. The default (/bgsys/drivers/ppcfloor/) is a link pointing to the currently active driver.

BGP_CROSS

A prefix to the pathnames of the GNU cross-compilers used to build the compute node and I/O node software.

BGCNS_H_PATH and BGCNS_H

The location of a file needed to rebuild the kernel (these options are temporary and will be removed in the next version).

OS_DIR

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

Typing make help will bring up the following menu:

[MENU]

make                       - Prepare Zepto kernel and ramdisk images

make bgp-ion-ramdisk-cnk   - Rebuild ION ramdisk for CNK
make bgp-ion-ramdisk-cnl   - Rebuild ION ramdisk for CNL

make bgp-ion-linux         - Simply use recent built or prebuilt ION kernel (no kernel rebuild)
make bgp-cn-linux          - Rebuild CN ramdisk and merge with recent built or prebuilt CN kernel objs

make bgp-ion-linux-build   - Rebuild ION kernel
make bgp-cn-linux-build    - Rebuild CN kernel objs and CN ramdisk, then merge them into CN Kernel

make bgp-all-pkg-smart     - Build packages from the prebuilt binaries
make bgp-all-pkg-rebuild   - Rebuild all packages from source

To start using the default built binaries simply type:

$ make

This will copy all the required kernel and ramdisk images to the top level directory.

Examining the Build Directory

If the build was successful, one should be able to see the following new files either rebuilt from sources or copied from their prebuilt locations:

$ ls -l
-rwxr-xr-x  1 hnaik users  8629983 2009-01-23 17:16 BGP-CN-zImage-with-initrd.elf
-rwxr-xr-x  1 hnaik users  1444183 2009-01-23 17:03 BGP-exp-ION-zImage.elf
-rwxr-xr-x  1 hnaik users 10423112 2009-01-23 17:03 BGP-ION-ramdisk-for-CNK.elf
-rwxr-xr-x  1 hnaik users 10423988 2009-01-23 17:03 BGP-ION-ramdisk-for-CNL.elf
-rw-r--r--  1 hnaik users      132 2009-01-23 17:03 bgp-ion-ramdisk-passwd.txt
-rwxr-xr-x  1 hnaik users  1351583 2009-01-23 17:08 BGP-ION-zImage.elf

---

Introduction | Top | Installation