Difference between revisions of "Configuration"

From ZeptoOS
Jump to navigationJump to search
Line 2: Line 2:
 
----
 
----
  
== Checklist ==
+
== Downloading ==
  
* It is necessary that the user is logged on the the login node.
+
* Log on one of the frontend nodes of the Blue Gene (a login node or a service node).
  
== Configuring the Build ==
+
* Download the ZeptoOS tarball from the ZeptoOS [http://press.mcs.anl.gov/zeptoos/download download page].
  
=== The Configure Script ===
+
* Extract the sources from the package:
Download the bzipped file on the [[Blue Gene/P]] login node. Extract the sources by using:
+
<pre>
<pre>$ tar xjf ZeptoOS-V20-V1R3M0-beta-20090401161133.tar.bz2 </pre>
+
tar xjf ZeptoOS-*.tar.bz2
 +
</pre>
  
Change to the BGP top directory using:
+
== Configuring ==
<pre>$ cd BGP/</pre>
 
  
Then you can use the ''configure'' script to set the system tools path to default using:
+
Change to the top-level <tt>BGP</tt> directory:
<pre>$ ./configure</pre>
 
  
In order to configure the site specific paths using the tool use:
+
<pre>
<pre>$ ./configure --edit</pre>
+
$ cd BGP/
 +
</pre>
  
== Building ZeptoOS V2.0 ==
+
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:
 +
 
 +
<pre>
 +
$ ./configure --edit
 +
</pre>
 +
 
 +
[[File:Configure1.png|Main menu]]
 +
 
 +
== Building ==
  
 
Typing ''make help'' will bring up the following menu:
 
Typing ''make help'' will bring up the following menu:

Revision as of 15:12, 5 May 2009

Introduction | Top | Installation


Downloading

  • Log on one of the frontend nodes of the Blue Gene (a login node or a service node).
  • 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

Main menu

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